Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # Uso de Amazon Chime SDK Utilice Amazon Chime SDK para crear aplicaciones multimedia en tiempo real que puedan enviar y recibir audio y video y que permitan compartir contenido. Amazon Chime SDK funciona de forma independiente de cualquier cuenta de administrador de Amazon Chime y no afecta a las reuniones organizadas en Amazon Chime. En cambio, Amazon Chime SDK proporciona herramientas de creación que puede utilizar para crear sus propias aplicaciones para reuniones. **Topics** + [Requisitos previos para usar Amazon Chime SDK](#mtg-prereqs) + [Conceptos de Amazon Chime SDK](#mtg-glossary) + [Arquitectura del Amazon Chime SDK](#mtg-arch) + [Cuotas de Amazon Chime SDK](#mtg-limits) + [Requisitos del sistema de Amazon Chime SDK](#mtg-browsers) + [Regiones de AWS disponibles para Amazon Chime SDK](sdk-available-regions.md) + [Más información sobre las bibliotecas cliente de Amazon Chime SDK](mtgs-sdk-client-lib.md) + [Descripción de la integración de SIP mediante un conector de voz de Amazon Chime SDK](mtgs-sdk-cvc.md) + [Descripción de las notificaciones de evento de Amazon Chime SDK](mtgs-sdk-notifications.md) + [Migración desde el espacio de nombres de Amazon Chime](migrate-from-chm-namespace.md) ## Requisitos previos para usar Amazon Chime SDK El uso de Amazon Chime SDK requiere lo siguiente: + Capacidad para programar. + Una AWS cuenta. + **Un rol de IAM con una política que otorga permiso para acceder a las acciones de la API de Amazon Chime utilizadas por el SDK de Amazon Chime, como AWS la política de SDK administrada. AmazonChime** Para obtener más información, consulte [Cómo funciona Amazon Chime con IAM](https://docs.aws.amazon.com/chime-sdk/latest/ag/security_iam_service-with-iam.html) y [Permitir a los usuarios acceder a las acciones de Amazon Chime SDK](https://docs.aws.amazon.com/chime-sdk/latest/ag/security_iam_id-based-policy-examples.html#security_iam_id-based-policy-examples-chime-sdk) en la *Guía del administrador de Amazon Chime SDK*. + En la mayoría de los casos, también necesitará: + Una **aplicación de servidor**: administra los recursos de las reuniones y los asistentes, y envía esos recursos a la aplicación cliente. La aplicación de servidor se crea en la AWS cuenta y debe tener acceso a la función de IAM mencionada anteriormente. + Una **aplicación cliente**: recibe información sobre las reuniones y los asistentes desde la aplicación de servidor y utiliza esa información para establecer conexiones multimedia. ## Conceptos de Amazon Chime SDK La terminología y los conceptos siguientes son fundamentales para comprender cómo utilizar Amazon Chime SDK: **reunión** Un recurso efímero identificado por un `MeetingId` único. `MeetingId` se incluye en un grupo de servicios de medios que albergan la reunión activa. **grupo de servicios multimedia** El grupo de servicios multimedia que albergan la reunión activa. **colocación de medios** Conjunto regionalizado URLs que representa un grupo de servicios multimedia. Los asistentes se conectan al grupo de servicios multimedia con sus clientes para enviar y recibir audio y video en tiempo real y compartir sus pantallas. **asistente** Un participante de la reunión que se identifica con un `AttendeeId` único. Los asistentes pueden entrar y salir de las reuniones libremente mediante una aplicación de cliente creada con una biblioteca de clientes de Amazon Chime SDK. **token de incorporación** Un token único asignado a cada asistente. Los asistentes utilizan el token de unión para autenticarse en el grupo de servicios multimedia. ## Arquitectura del Amazon Chime SDK En la siguiente lista se describe cómo los distintos componentes de la arquitectura de Amazon Chime SDK funcionan en conjunto para respaldar las reuniones y los asistentes, así como el uso compartido de audio, video y contenido. **Reuniones y asistentes** Cuando la aplicación de servidor crea una reunión de Amazon Chime SDK, la reunión se asigna a un servicio multimedia específico de la región. Los anfitriones del servicio son responsables de transferir de forma segura los contenidos multimedia en tiempo real entre los clientes asistentes. A cada asistente creado se le asigna un token de entrada único, una clave secreta opaca que la aplicación de su servidor debe transferir de forma segura al cliente autorizado a unirse a la reunión en nombre del asistente. Cada cliente usa un token de unión para autenticarse en el grupo de servicios multimedia. Los clientes utilizan una combinación de seguridad WebSockets y seguridad de capa de transporte de datagramas (DTLS) para enviar señales de forma segura al grupo de servicios multimedia y para enviar y recibir contenido multimedia a y desde otros asistentes a través del grupo de servicios multimedia. **Audio** El servicio multimedia mezcla el audio de cada asistente y envía la mezcla a cada destinatario, después de restar su propio audio de la mezcla. El Amazon Chime SDKs muestrea el audio a la velocidad más alta admitida por el dispositivo y el navegador, hasta un máximo de 48 kHz. Usamos el códec Opus para codificar audio, con una tasa de bits predeterminada de 32 kbps, que se puede aumentar hasta 128 kbps en estéreo y 64 kbps en mono. **Video** El servicio multimedia actúa como una unidad de reenvío selectivo (SFU) mediante un modelo de publicación y suscripción. Cada asistente puede publicar una fuente de video, hasta un total de 25 videos simultáneos por reunión. La biblioteca de clientes del SDK de Amazon Chime JavaScript admite resoluciones de vídeo de hasta 1280 x 720 a 30 fotogramas por segundo sin transmisión simultánea y 15 fotogramas por segundo con transmisión simultánea. Las bibliotecas cliente de Amazon Chime SDK para [iOS](sdk-for-ios.md), [Android](sdk-for-android.md) y [Windows](client-lib-windows.md) admiten resoluciones de video de hasta 1280 x 720 y 30 fotogramas por segundo; sin embargo, Amazon Chime SDK administra automáticamente la velocidad de fotogramas y la resolución reales. Cuando está activa, la transmisión simultánea de video envía cada transmisión de video en dos resoluciones y velocidades de bits diferentes. Los clientes con restricciones de ancho de banda se suscriben automáticamente a la transmisión con una tasa de bits más baja. La codificación y decodificación de video utilizan la aceleración de hardware cuando está disponible para mejorar el rendimiento. **Mensajes de datos** Además del contenido de audio y video, los asistentes a la reunión pueden enviarse mensajes de datos en tiempo real de hasta 2 KB cada uno. Puede usar los mensajes para implementar características de reunión personalizadas, como la pizarra, el chat, las reacciones a los emojis en tiempo real y la señalización de control de sala específica para cada aplicación. **Uso compartido de contenido** La aplicación cliente puede compartir contenido de audio y video, como capturas de pantalla o archivos multimedia. El intercambio de contenido admite contenido pregrabado, video de hasta 1280 x 720 a 15 cuadros por segundo y audio de hasta 48 kHz a 64 kbps. La captura de pantalla para compartir contenido se admite hasta 15 fotogramas por segundo, pero puede estar limitada por las capacidades del dispositivo y el navegador. ## Cuotas de Amazon Chime SDK Las cuotas del servicio Amazon Chime SDK están documentadas en la Referencia general de AWS. Para obtener más información, consulte [Puntos de conexión y cuotas de Amazon Chime SDK](https://docs.aws.amazon.com/general/latest/gr/chime-sdk.html) en la *Referencia general de AWS*. **nota** Las Service Quotas se calculan por punto de conexión de la API. Cuando solicite un aumento de la Sevice Quota, asegúrese de solicitarlo en todos los puntos de conexión de la API que utilice su aplicación. ## Requisitos del sistema de Amazon Chime SDK Los siguientes requisitos del sistema se aplican a las aplicaciones creadas con Amazon Chime SDK. **Navegadores compatibles, biblioteca de clientes del SDK de Amazon Chime para JavaScript** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/chime-sdk/latest/dg/meetings-sdk.html) **Biblioteca de clientes de Amazon Chime SDK para iOS** + iOS, versión 13 y posteriores **Biblioteca de clientes de Amazon Chime SDK para Android** + Sistema operativo Android versión 5 y posteriores, ARM y ARM64 arquitectura # Regiones de AWS disponibles para Amazon Chime SDK En las tablas siguientes se enumeran las características del servicio SDK de Amazon Chime y las AWS regiones que ofrecen cada servicio. **nota** Las regiones marcadas con un asterisco (**\$1**) deben estar habilitadas en su AWS cuenta. AWS bloquea esas regiones de forma predeterminada. Para obtener más información sobre cómo habilitar las regiones, consulte [Especificar qué AWS regiones puede usar su cuenta](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html), en la *Referencia de administración de AWS cuentas*. **Topics** + [Regiones de consola](#sdk-console-regions) + [Regiones de análisis de llamadas](#call-analytics-regions) + [Regiones de reunión](#sdk-meeting-regions) + [Regiones de canalización de medios](#sdk-media-pipelines) + [Regiones de mensajería](#sdk-messaging-regions) + [Regiones de voz](#voice-regions) ## Regiones de consola Utilice la consola de Amazon Chime SDK para configurar los recursos y obtener más información sobre el servicio Amazon Chime SDK. | **AWS Region** | **Consola** | | --- | --- | | Asia-Pacífico (Seúl) | Sí | | Asia-Pacífico (Singapur) | Sí | | Asia-Pacífico (Sídney) | Sí | | Asia-Pacífico (Tokio) (ap-northeast-1) | Sí | | Canadá (centro) (ca-central-1) | Sí | | Europa (Fráncfort) (eu-central-1) | Sí | | Europa (Irlanda) (eu-west-1) | Sí | | Europa (Londres) (eu-west-2) | Sí | | Este de EE. UU. (Norte de Virginia) (us-east-1) | Sí | | Oeste de EE. UU. (Oregón) (us-west-2) | Sí | ## Regiones de análisis de llamadas En la siguiente tabla se enumeran las AWS regiones disponibles para el análisis, la transcripción y la grabación de llamadas. | **AWS Region** | **Análisis de voz** | **Transcripción** | **Grabaciones de llamadas** | | --- | --- | --- | --- | | Este de EE. UU. (Norte de Virginia) (us-east-1) | Sí | Sí | Sí | | Oeste de EE. UU. (Oregón) (us-west-2) | Sí | Sí | Sí | | Europa (Fráncfort) (eu-central-1) | No | Sí | Sí | ## Regiones de reunión Las reuniones de Amazon Chime SDK tienen *regiones de control* y *regiones multimedia*. Una región de control proporciona el punto de conexión de la API que se utiliza para crear, actualizar y eliminar reuniones. Las regiones de control también reciben y procesan [Descripción de los eventos de ciclo de vida de reuniones de Amazon Chime SDK](using-events.md). Las regiones multimedia albergan las reuniones propiamente dichas y los clientes se conectan a sus regiones multimedia. Al llamar a la API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html) especifique la región multimedia. Una región de control puede crear una reunión en cualquier región multimedia de la misma AWS partición. Sin embargo, solo puede actualizar una reunión en la región de control utilizada para crearla. Para más información sobre la selección de regiones de control y medios, consulte [Uso de regiones de reuniones para reuniones de Amazon Chime SDK](chime-sdk-meetings-regions.md). En la siguiente tabla se muestran las regiones que proporcionan control, medios de comunicación o ambos. | **AWS Region** | **Control de reuniones** | **Medios para reuniones** | | --- | --- | --- | | África (Ciudad del Cabo) (af-south-1)**\$1** | Sí\$1\$1 | Sí | | Asia Pacífico (Bombay) (ap-south-1) | Sí | Sí | | Asia-Pacífico (Seúl) (ap-northeast-2) | Sí | Sí | | Asia-Pacífico (Singapur) (ap-southeast-1) | Sí | Sí | | Asia-Pacífico (Sídney) (ap-southeast-2) | Sí | Sí | | Asia-Pacífico (Tokio) (ap-northeast-1) | Sí | Sí | | Canadá (centro) (ca-central-1) | Sí | Sí | | Europa (Fráncfort) (eu-central-1) | Sí | Sí | | Europa (Irlanda) (eu-west-1) | | Sí | | Europa (Londres) (eu-west-2) | Sí | Sí | | Europa (Milán) (eu-south-1)**\$1** | | Sí | | Europa (París) (eu-west-3) | | Sí | | Europa (Estocolmo) (eu-north-1) | | Sí | | Israel (Tel Aviv) (il-central-1)**\$1** | Sí**\$1\$1** | Sí | | América del Sur (São Paulo) (sa-east-1) | | Sí | | Este de EE. UU. (Ohio) (us-east-2) | | Sí | | Este de EE. UU. (Norte de Virginia) (us-east-1) | Sí | Sí | | EE. UU. Oeste (Norte de California) (us-west-1) | | Sí | | Oeste de EE. UU. (Oregón) (us-west-2) | Sí | Sí | | AWS GovCloud (EEUU-Este) (us-gov-east-1) | Sí | Sí | | AWS GovCloud (EEUU-Oeste) (us-gov-west-1) | Sí | Sí | **\$1** Debe habilitar estas regiones en su AWS cuenta. Para obtener más información, consulte [Habilitar una región](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html#rande-manage-enable) en la *Referencia general de AWS *. **\$1\$1** Las reuniones que utilizan el control de reuniones en esta región solo pueden albergar contenido multimedia de esta región. **nota** Para crear una reunión en una región AWS GovCloud (EE. UU.), debe usar una región de control en GovCloud. Además, el control Regions in solo GovCloud puede celebrar reuniones en las regiones AWS GovCloud (EE. UU.). ## Regiones de canalización de medios Los canales multimedia de Amazon Chime SDK tienen *regiones de control* y *regiones multimedia.* Una región de control proporciona el punto de conexión de la API de canales de contenido multimedia que se utiliza para crear y eliminar canales de contenido multimedia. También se utilizan las regiones de control para recibir y procesar [los eventos de canalización de medios](media-pipe-events.md). Las regiones multimedia gestionan sus canales multimedia y el sistema selecciona automáticamente la misma región multimedia que la reunión. Puede utilizar una región de control para crear una canalización de medios en cualquier región de datos. El canal multimedia puede unirse a una reunión en cualquier región multimedia de reuniones. | **AWS Region** | **Controlar** | **Multimedia** | | --- | --- | --- | | África (Ciudad del Cabo) (af-south-1)**\$1** | | Sí | | Asia Pacífico (Bombay) (ap-south-1) | Sí | Sí | | Asia-Pacífico (Seúl) (ap-northeast-2) | Sí | Sí | | Asia-Pacífico (Singapur) (ap-southeast-1) | Sí | Sí | | Asia-Pacífico (Sídney) (ap-southeast-2) | Sí | Sí | | Asia-Pacífico (Tokio) (ap-northeast-1) | Sí | Sí | | Canadá (centro) (ca-central-1) | Sí | Sí | | Europa (Fráncfort) (eu-central-1) | Sí | Sí | | Europa (Irlanda) (eu-west-1) | | Sí | | Europa (Londres) (eu-west-2) | Sí | Sí | | Europa (Milán) (eu-south-1)**\$1** | | Sí | | Europa (París) (eu-west-3) | | Sí | | Europa (Estocolmo) (eu-north-1) | | Sí | | América del Sur (São Paulo) (sa-east-1) | | Sí | | Este de EE. UU. (Ohio) (us-east-2) | | Sí | | Este de EE. UU. (Norte de Virginia) (us-east-1) | Sí | Sí | | EE. UU. Oeste (Norte de California) (us-west-1) | | Sí | | Oeste de EE. UU. (Oregón) (us-west-2) | Sí | Sí | **\$1** Debe habilitar estas regiones en su AWS cuenta. Para obtener más información, consulte [Habilitar una región](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html#rande-manage-enable) en la *Referencia general de AWS *. ## Regiones de mensajería La mensajería de Amazon Chime SDK tiene *regiones de control* y *regiones de datos*. La región de control expone el punto de conexión de la API de mensajería y la región de datos almacena los mensajes. Si utiliza Amazon Kinesis para transmitir datos de mensajería o AWS Lambda funciones para flujos de canales, deben residir en la región de control. | **AWS Region** | **Controlar** | **Datos** | | --- | --- | --- | | Europa (Fráncfort) (eu-central-1) | Sí | Sí | | Este de EE. UU. (Norte de Virginia) (us-east-1) | Sí | Sí | ## Regiones de voz Las características del SIP (Protocolo de inicio de sesión) de Amazon Chime SDK incluyen *regiones de API*, *regiones multimedia* y *regiones de PSTN*. Las regiones de la API proporcionan los puntos de conexión de la API para crear y configurar las características del SIP. Las regiones multimedia contienen conectores de voz de Amazon Chime SDK y aplicaciones multimedia SIP. Las regiones PSTN permiten a los clientes conectar los sistemas telefónicos en las instalaciones a la red telefónica pública. Además, las regiones PSTN admiten el aprovisionamiento y la administración de números de teléfono. | **AWS Region** | **API** | **Multimedia** | **PSTN** | | --- | --- | --- | --- | | Asia-Pacífico (Seúl) (ap-northeast-2) | Sí | Sí | | | Asia-Pacífico (Singapur) (ap-southeast-1) | Sí | Sí | | | Asia-Pacífico (Sídney) (ap-southeast-2) | Sí | Sí | | | Asia-Pacífico (Tokio) (ap-northeast-1) | Sí | Sí | | | Canadá (centro) (ca-central-1) | Sí | Sí | | | Europa (Fráncfort) (eu-central-1) | Sí | Sí | | | Europa (Irlanda) (eu-west-1) | Sí | Sí | | | Europa (Londres) (eu-west-2) | Sí | Sí | | | Este de EE. UU. (Norte de Virginia) (us-east-1) | Sí | Sí | Sí**\$1** | | Oeste de EE. UU. (Oregón) (us-west-2) | Sí | Sí | Sí**\$1** | **\$1** Consulte la página de [precios del SDK de Amazon Chime](https://aws.amazon.com/chime/chime-sdk/pricing/) para obtener información sobre la disponibilidad de números de teléfono en regiones específicas AWS . # Más información sobre las bibliotecas cliente de Amazon Chime SDK Antes de poder crear clientes para reuniones en tiempo real con Amazon Chime SDK, debe integrar la aplicación de cliente con una biblioteca de clientes de Amazon Chime SDK. Están disponibles las siguientes bibliotecas de clientes: + [Biblioteca de clientes de Amazon Chime SDK para Android](https://github.com/aws/amazon-chime-sdk-android): biblioteca de Kotlin que le ayuda a crear aplicaciones de Amazon Chime SDK en dispositivos Android compatibles. + [Biblioteca de clientes de señalización de Amazon Chime SDK para C\$1\$1](https://github.com/aws/amazon-chime-sdk-cpp/tree/main/chime-sdk-signaling-cpp): biblioteca de C\$1\$1 que le ayuda a configurar conexiones de señalización para las reuniones de Amazon Chime SDK en dispositivos integrados. + [Biblioteca de clientes de Amazon Chime SDK para iOS](https://github.com/aws/amazon-chime-sdk-ios): una biblioteca de Swift que le ayuda a crear aplicaciones de Amazon Chime SDK en dispositivos iOS compatibles. + [Biblioteca cliente del SDK de Amazon Chime para JavaScript ([NPM](https://www.npmjs.com/package/amazon-chime-sdk-js)): una JavaScript biblioteca](https://github.com/aws/amazon-chime-sdk-js) con definiciones de TypeScript tipos que le ayuda a crear aplicaciones del SDK de Amazon Chime en navegadores compatibles con WebRTC. + [Biblioteca de clientes de Amazon Chime SDK para Windows](https://github.com/aws/amazon-chime-sdk-cpp). Una biblioteca de C\$1\$1 que le ayuda a crear aplicaciones de Amazon Chime SDK en dispositivos compatibles. Para obtener información sobre cómo integrar su aplicación cliente con Amazon Chime SDK, consulte las acciones en los archivos de la biblioteca `README.md` del cliente. Utilice las demostraciones para aprender a crear componentes multimedia específicos para su aplicación. # Descripción de la integración de SIP mediante un conector de voz de Amazon Chime SDK Integre su infraestructura de voz compatible con SIP con un conector de voz de Amazon Chime SDK para realizar llamadas de voz SIP. Debe usar la región `us-east-1` o `us-east-2`. Debe disponer de una centralita automática privada (PBX) con tecnología IP, un controlador de frontera de sesión (SBC) u otra infraestructura de voz con acceso a Internet que admita el Protocolo de inicio de sesión (SIP). Para obtener más información, consulte [Antes de empezar](https://docs.aws.amazon.com/chime-sdk/latest/ag/voice-connectors.html#vc-prereq) en la *Guía del administrador de Amazon Chime SDK*. **Para integrar su infraestructura de voz** 1. Cree un conector de voz del SDK de Amazon Chime en su AWS cuenta. Para obtener más información, consulte [Creación de un conector de voz de Amazon Chime SDK en la ](https://docs.aws.amazon.com/chime-sdk/latest/ag/voice-connectors.html#create-voicecon)Guía del administrador de Amazon Chime SDK**. 1. Edite la configuración del conector de voz de Amazon Chime SDK para permitir las llamadas desde su infraestructura de voz a AWS. Para obtener más información, consulte [Edición de la configuración del conector de voz de Amazon Chime SDK](https://docs.aws.amazon.com/chime-sdk/latest/ag/voice-connectors.html#edit-voicecon) en la *Guía del administrador de Amazon Chime SDK*. 1. Seleccione **Configuración de terminación** y seleccione **Habilitado**. 1. En **Lista de permitidos**, seleccione **Nuevo**. 1. Introduzca las anotaciones CIDR de las direcciones IP de su infraestructura SIP interna. Esto permite que su infraestructura acceda al conector de voz de Amazon Chime SDK. Por ejemplo, para permitir el tráfico desde la dirección IP `10.24.34.0`, incluya en la lista de permitidos la notación CIDR `10.24.34.0/32`. 1. Elija **Agregar**. 1. En **Calling plan (Plan de llamadas)**, seleccione el país o los países que desea añadir a su plan de llamadas. 1. Edite cualquier otra configuración según sea necesario y seleccione **Guardar**. 1. En la consola de Amazon Chime SDK, en **Conectores de voz**, consulte el **Nombre del host de salida** de su conector de voz de Amazon Chime SDK. Por ejemplo, *abcdef1ghij2klmno3pqr4* .voiceconnector.chime.aws. 1. Para unirse a una reunión con Amazon Chime SDK, utilice un URI de SIP para realizar una solicitud de SIP al **nombre del host de salida** de su conector de voz de Amazon Chime SDK. Use el número de teléfono **\$117035550122** en el URI del SIP. Establezca el parámetro `transport` para usar el protocolo TLS. Por último, utilice el token de unión único que se genera al llamar al [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateAttendee.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateAttendee.html)Acción de API. Para obtener más información, consulte el siguiente ejemplo. **Example Ejemplo: Solicitud SIP** El siguiente ejemplo muestra el contenido de un URI de SIP utilizado para realizar una solicitud de SIP a un conector de voz de Amazon Chime SDK. ``` sip:+17035550122@abcdef1ghij2klmno3pqr4.voiceconnector.chime.aws;transport=tls;X-chime-join-token=join-token ``` El siguiente ejemplo muestra un ejemplo de mensaje SIP INVITE para unirse a una reunión de Amazon Chime SDK. ``` INVITE sip:+17035550122@abcdef1ghij2klmno3pqr4.voiceconnector.chime.aws;transport=tls;X-chime-join-token=join-token SIP/2.0 Via: SIP/2.0/TLS IPaddress:12345;rport;branch=branch;alias Max-Forwards: 70 From: sip:+12065550100@IPaddress;tag=tag To: sip:+17035550122@abcdef1ghij2klmno3pqr4.voiceconnector.chime.aws;X-chime-join-token=join-token Contact: Call-ID: a1234567-89b0-1c2d-e34f-5gh678j9k2lm CSeq: 6214 INVITE Allow: PRACK, INVITE, ACK, BYE, CANCEL, UPDATE, INFO, SUBSCRIBE, NOTIFY, REFER, MESSAGE, OPTIONS Supported: replaces, 100rel, timer, norefersub Session-Expires: 1800 Min-SE: 90 Content-Type: application/sdp Content-Length: 991 v=0 o=- 3775321410 3775321410 IN IP4 IPaddress s=pjmedia b=AS:117 t=0 0 a=X-nat:0 m=audio 4000 RTP/SAVP 0 3 8 9 125 101 c=IN IP4 IPaddress b=TIAS:96000 a=rtcp:4001 IN IP4 IPaddress a=sendrecv a=rtpmap:0 PCMU/8000 a=rtpmap:3 GSM/8000 a=rtpmap:8 PCMA/8000 a=rtpmap:9 G722/8000 a=rtpmap:125 opus/48000/2 a=fmtp:125 useinbandfec=1 a=rtpmap:101 telephone-event/8000 a=fmtp:101 0-16 a=crypto:1 AEAD_AES_256_GCM inline:EXAMPLE a=crypto:2 AEAD_AES_256_GCM_8 inline:EXAMPLE a=crypto:3 AES_256_CM_HMAC_SHA1_80 inline:EXAMPLE a=crypto:4 AES_256_CM_HMAC_SHA1_32 inline:EXAMPLE a=crypto:5 AES_CM_128_HMAC_SHA1_80 inline:EXAMPLE a=crypto:6 AES_CM_128_HMAC_SHA1_32 inline:EXAMPLE ``` **nota** Amazon Chime SDK solo reconoce los números de teléfono en formato E.164. Asegúrese de que haya un número de teléfono E.164 en el encabezado de `From`. # Descripción de las notificaciones de evento de Amazon Chime SDK El SDK de Amazon Chime permite enviar notificaciones de eventos de reuniones a Amazon EventBridge, Amazon Simple Queue Service (SQS) y Amazon Simple Notification Service (SNS). **nota** El espacio de nombres predeterminado de reuniones de Amazon Chime SDK utiliza los puntos de conexión de `ChimeSDKMeetings`. El espacio de nombres Chime heredado utiliza un único punto de conexión. Para obtener más información acerca de los espacios de nombres y puntos de conexión, consulte [Migración al espacio de nombres Meetings de Amazon Chime SDK](meeting-namespace-migration.md), en un apartado anterior de esta guía. ## Enviar notificaciones a EventBridge Puede enviar notificaciones de eventos del SDK de Amazon Chime a. EventBridge *Para obtener información detallada sobre el uso del SDK de Amazon Chime con EventBridge, consulte [Automatización del SDK de Amazon Chime con en la Guía del administrador del SDK](https://docs.aws.amazon.com/chime-sdk/latest/ag/automating-chime-with-cloudwatch-events.html#events-sdk) de EventBridge Amazon Chime.* Para obtener más información EventBridge, consulta la [Guía del EventBridge usuario de Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/). ## Envío de notificaciones a Amazon SQS y Amazon SNS Puede utilizar la API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html) de la *referencia de la API de Amazon Chime SDK* para enviar notificaciones de eventos de reuniones de Amazon Chime SDK a una cola de Amazon SQS y a un tema de Amazon SNS por reunión. Esto puede ayudar a reducir la latencia de las notificaciones. Para obtener más información sobre Amazon SQS, consulte la [Guía del desarrollador de Amazon Simple Queue Service](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/). Para obtener más información sobre Amazon SNS, consulte la [Guía para desarrolladores de Amazon Simple Notification Service](https://docs.aws.amazon.com/sns/latest/dg/). Las notificaciones enviadas a Amazon SQS y Amazon SNS contienen la misma información que las notificaciones a las que envía el SDK de Amazon Chime. EventBridge Amazon Chime SDK admite el envío de notificaciones de eventos de reuniones a colas y temas de la región de API utilizada para crear una reunión. Es posible que las notificaciones de eventos se envíen fuera del orden en que se produjeron. ## Concesión del acceso de Amazon Chime SDK a Amazon SQS y Amazon SNS Antes de que Amazon Chime SDK pueda enviarle notificaciones a través de una cola de Amazon SQS o un tema de Amazon SNS, debe conceder permiso al Amazon Chime SDK para publicar mensajes en el nombre de recurso de Amazon (ARN) de la cola o el tema. Para ello, adjunte una política AWS Identity and Access Management (de IAM) a la cola o al tema que conceda los permisos adecuados al SDK de Amazon Chime. Para obtener más información, consulte [Gestión de identidades y accesos en Amazon SQS](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-authentication-and-access-control.html) en la *Guía para desarrolladores de Amazon Simple Queue Service* y [Ejemplos de casos de control de acceso a Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-access-policy-use-cases.html) en la *Guía para desarrolladores de Amazon Simple Notification Service*. **nota** La cola de Amazon SQS o el tema de Amazon SNS deben utilizar la misma región que el punto de enlace de la API del AWS SDK de Amazon Chime. **Example Permita que Amazon Chime SDK publique eventos en una cola de Amazon SQS** El siguiente ejemplo de política de IAM concede a Amazon Chime SDK permiso para publicar notificaciones de eventos de reuniones en la cola de Amazon SQS especificada. Anote la declaración condicional para `aws:SourceArn` y `aws:SourceAccount`. Abordan posibles problemas de [Suplente confuso](https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html). + Puede utilizar `aws:SourceArn` o `aws:SourceAccount` al crear las políticas que aparecen a continuación. No tiene que usar ambas opciones. + En estos ejemplos se utiliza el espacio de nombres `ChimeSDKMeetings` y el punto de conexión correspondiente. Si utiliza el espacio de nombres `Chime`, debe usar el punto de conexión `chime.amazonaws.com`. **** ``` { "Version":"2012-10-17", "Id": "example-ID", "Statement": [ { "Sid": "example-statement-ID", "Effect": "Allow", "Principal": { "Service": "meetings.chime.amazonaws.com" }, "Action": [ "sqs:SendMessage", "sqs:GetQueueUrl" ], "Resource": "arn:aws:sqs:us-east-1:111122223333:queueName", "Condition": { "ArnLike": { "aws:SourceArn": "arn:aws:chime:us-east-1:111122223333:*" }, "StringEquals": { "aws:SourceAccount": "111122223333" } } } ] } ``` En este ejemplo, se muestra una política de Amazon SNS que permite a Amazon Chime SDK enviar notificaciones de eventos de reuniones a su tema de SNS. **** ``` { "Version":"2012-10-17", "Id": "example-ID", "Statement": [ { "Sid": "allow-chime-sdk-access-statement-id", "Effect": "Allow", "Principal": { "Service": "meetings.chime.amazonaws.com" }, "Action": [ "SNS:Publish" ], "Resource": "arn:aws:sns:us-east-1:111122223333:topicName", "Condition": { "ArnLike": { "aws:SourceArn": "arn:aws:chime:us-east-1:111122223333:*" }, "StringEquals": { "aws:SourceAccount": "111122223333" } } } ] } ``` Si la cola de Amazon SQS está habilitada para el cifrado del servidor (SSE), debe realizar un paso adicional. Adjunte una política de IAM a la AWS KMS clave asociada que otorgue permiso al SDK de Amazon Chime para realizar AWS KMS las acciones necesarias para cifrar los datos añadidos a la cola. **** ``` { "Version":"2012-10-17", "Id": "example-ID", "Statement": [ { "Sid": "example-statement-ID", "Effect": "Allow", "Principal": { "Service": "meetings.chime.amazonaws.com" }, "Action": [ "kms:GenerateDataKey", "kms:Decrypt" ], "Resource": "*" } ] } ``` **Example Permitir que Amazon Chime SDK publique eventos en un tema de Amazon SNS** El siguiente ejemplo de política de IAM concede a Amazon Chime SDK permiso para publicar notificaciones de eventos de reuniones en el tema de Amazon SNS especificado. **** ``` { "Version":"2012-10-17", "Id": "example-ID", "Statement": [ { "Sid": "allow-chime-sdk-access-statement-id", "Effect": "Allow", "Principal": { "Service": "meetings.chime.amazonaws.com" }, "Action": [ "SNS:Publish" ], "Resource": "arn:aws:sns:us-east-1:111122223333:topicName", "Condition": { "ArnLike": { "aws:SourceArn": "arn:aws:chime:us-east-1:111122223333:*" }, "StringEquals": { "aws:SourceAccount": "111122223333" } } } ] } ``` # Migración desde el espacio de nombres de Amazon Chime El SDK de Amazon Chime se expone APIs en un conjunto de puntos de conexión. Si bien puede realizar solicitudes HTTPS directamente a los puntos de conexión, muchos clientes utilizan el AWS SDK en sus aplicaciones para llamar al servicio. APIs El AWS SDK está disponible en diferentes idiomas y simplifica las llamadas a la API al encapsular la lógica de firma y reintento de las solicitudes. El AWS SDK incluye un espacio de nombres para cada punto final del servicio. Cuando se lanzó por primera vez, Amazon Chime SDK compartía un único punto de conexión con la aplicación Amazon Chime. Como resultado, las soluciones utilizaron el espacio de `Chime` nombres del AWS SDK para llamar a la aplicación Amazon Chime y al SDK Amazon Chime. APIs Amazon Chime SDK ahora proporciona puntos de conexión dedicados para cada subservicio, como reuniones y audio PSTN. Cada punto final se puede direccionar a través de un espacio de nombres dedicado en el SDK. AWS En los temas siguientes se enumeran los servicios, los espacios de nombres y los puntos finales, y se describe cómo usarlos en el código y con la CLI. AWS **Topics** + [Puntos de conexión, espacios de nombres y comandos CLI](#endpoint-namespace-cli) + [Ayuda de migración de cada servicio](#help-per-service) + [Mapeo de API](#name-end-map) ## Puntos de conexión, espacios de nombres y comandos CLI En la siguiente tabla se enumeran los espacios de nombres, los puntos de conexión y los comandos de CLI dedicados de Amazon Chime SDK. Los enlaces le llevan a más información sobre cada servicio. | Punto de conexión | AWS Espacio de nombres del SDK | AWS CLI DEL SDK | | --- | --- | --- | | [identity-chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Identity.html) | Campanilla SDKIdentity | [https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-identity/index.html](https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-identity/index.html) | | [media-pipelines-chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Media_Pipelines.html) | Tuberías Chime SDKMedia | [https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-media-pipelines/index.html](https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-media-pipelines/index.html) | | [meetings-chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) | Campanilla SDKMeetings | [https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-meetings/index.html](https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-meetings/index.html) | | [messaging-chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.html) | Campanilla SDKMessaging | [https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-messaging/index.html](https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-messaging/index.html) | | [voice-chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Voice.html) | Campanilla SDKVoice | [https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-voice/index.html](https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-voice/index.html) | ## Ayuda de migración de cada servicio Todos los clientes deberían considerar la posibilidad de utilizar los puntos de enlace dedicados del SDK de Amazon Chime para acceder a las últimas funciones y regiones del SDK de Amazon Chime. APIs AWS Si utiliza el punto de conexión compartido con el espacio de nombres `Chime`, las siguientes guías de migración pueden ayudarle a comprender las diferencias técnicas antes de realizar la migración. + [Migración al espacio de nombres Amazon Chime SDKIdentity ](identity-namespace-migration.md) + [Migración al espacio de nombres Amazon SDKMedia Chime Pipelines](migrate-pipelines.md) + [Migración al espacio de nombres Amazon Chime SDKMeetings ](meeting-namespace-migration.md) + [Migración al espacio de nombres Amazon Chime SDKMessaging ](messaging-namespace-migration.md) + [Migración al espacio de nombres Amazon Chime SDKVoice ](voice-namespace-migration.md) ## Mapeo de API En la siguiente tabla se muestran los espacios de nombres APIs incluidos en el espacio de `Chime` nombres y sus correspondientes espacios de nombres dedicados y. APIs Algunas de las instancias dedicadas APIs difieren de las `Chime` APIs, y la tabla indica esas instancias. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/chime-sdk/latest/dg/migrate-from-chm-namespace.html) **\$1** La API ha sido sustituida por una API con otro nombre. **\$1** La API ya no está disponible.