SDK y API REST
Las funcionalidades de Azure Communication Services se organizan conceptualmente en áreas discretas en función de su área funcional. La mayoría de las áreas tienen SDK de código abierto totalmente programados con las API de REST publicadas que puede usar directamente a través de Internet. Calling SDK usa interfaces de red propietarias y tiene formato de código cerrado.
En las tablas siguientes se resumen estas áreas y la disponibilidad de las API REST y las bibliotecas del SDK. Observamos si las API y los SDK están diseñados para clientes de usuario final o entornos de servicio de confianza. Los dispositivos de usuario final de entornos de confianza baja no deben acceder directamente a las API, como SMS.
El desarrollo de aplicaciones de llamadas y chat basadas en web puede acelerarse con la biblioteca de interfaz de usuario de Azure Communication Services. La biblioteca de interfaz de usuario personalizable proporciona componentes de interfaz de usuario de código abierto para aplicaciones web y móviles, y un tema de Microsoft Teams personalizado.
Creación de una práctica para usar el SDK más reciente
Los exploradores y los sistemas operativos evolucionan constantemente para admitir las últimas mejoras y corregir los errores existentes. El uso del SDK de Azure Communication Services más reciente puede ayudarle a lograr la mejor experiencia general del usuario final para la aplicación cuando se usa con exploradores actualizados y actualizaciones del sistema operativo. El SDK de Azure Communication Services más actualizado ofrece muchas ventajas, como un mejor rendimiento, seguridad, compatibilidad, calidad y facilidad de uso. La actualización le permite acceder a las características y actualizaciones más recientes que se agregan periódicamente al explorador y al sistema operativo. Los SDK de Azure Communication Services se actualizan con frecuencia (aproximadamente cada 6 semanas a una vez al trimestre). Se recomienda crear un proceso para asegurarse de que siempre está actualizando a los SDK más recientes.
SDK
| Ensamblado | Protocolos | Entorno | Funcionalidades |
|---|---|---|---|
| Azure Resource Manager | REST | Service | Aprovisiona y administra recursos de Communication Services. |
| Comunes | N/D | Cliente y servicio | Proporciona tipos base para otros SDK |
| Identidad | REST | Service | Administración de usuarios y tokens de acceso |
| Números de teléfono | REST | Service | Adquisición y administración de números de teléfono |
| SMS | REST | Service | Enviar y recibir mensajes SMS |
| REST | Service | Envío y obtención del estado en los mensajes de correo electrónico | |
| Chat | REST con señalización propietaria | Cliente y servicio | Incorpora chat de texto en tiempo real a las aplicaciones. |
| Llamar | Transporte propietario | Remoto | Permite usar la voz, el vídeo, el uso compartido de pantalla y otras comunicaciones en tiempo real. |
| Automatización de llamadas | REST | Service | Creación de flujos de trabajo de llamadas personalizados para llamadas RTC y VoIP |
| Enrutador de trabajos | REST | Service | Optimización de la administración de interacciones de clientes en varias aplicaciones |
| Salas | REST | Service | Creación y administración de salas de comunicación estructuradas |
| Biblioteca de interfaz de usuario | N/D | Remoto | Componentes de interfaz de usuario listos para producción para aplicaciones de chat y de llamadas |
| Mensajería avanzada | REST | Service | Envío y recepción de mensajes de WhatsApp Business |
Idiomas y ubicaciones de publicación
Ubicaciones de publicación para paquetes de SDK individuales:
| Área | JavaScript | .NET | Python | Java SE | iOS | Android | Otros |
|---|---|---|---|---|---|---|---|
| Azure Resource Manager | npm | NuGet | PyPi | Maven | - | - | Go a través de GitHub |
| Comunes | npm | NuGet | N/D | Maven | GitHub | Maven | - |
| Identidad | npm | NuGet | PyPi | Maven | - | - | - |
| Números de teléfono | npm | NuGet | PyPi | Maven | - | - | - |
| Chat | npm | NuGet | PyPi | Maven | GitHub | Maven | - |
| SMS | npm | NuGet | PyPi | Maven | - | - | - |
| npm | NuGet | PyPi | Maven | - | - | - | |
| Llamar | npm | NuGet | - | - | CocoaPods | Maven | - |
| Automatización de llamadas | npm | NuGet | PyPi | Maven | |||
| Enrutador de trabajos | npm | NuGet | PyPi | Maven | |||
| Salas | npm | NuGet | PyPi | Maven | - | - | - |
| Biblioteca de interfaz de usuario | npm | - | - | - | GitHub | GitHub | GitHub, Storybook |
| Mensajería avanzada | npm | NuGet | PyPi | Maven | - | - | - |
| Documentación de referencia | Documentación | Documentación | Documentación | Documentación | Documentación | Documentación | - |
Detalles de compatibilidad de la plataforma de SDK
Compatibilidad con el SDK de llamada de Android
- Compatibilidad con Android API Nivel 21 o superior
- Compatibilidad con Java 7 o posterior
- Compatibilidad con Android Studio 2.0
Compatibilidad con la plataforma Android
El ecosistema de Android es extenso, que abarca varias versiones y plataformas especializadas diseñadas para diversos tipos de dispositivos. En la tabla siguiente se enumeran las plataformas Android admitidas actualmente:
| Dispositivos | Descripción | Soporte técnico |
|---|---|---|
| Teléfonos y tabletas | Dispositivos estándar que ejecutan Android Commercial. | Totalmente compatible con la resolución de vídeo. |
Nota:
Solo se admiten videollamadas en teléfonos y tabletas. Para casos de uso que implican vídeo en dispositivos o plataformas no estándar (como gafas inteligentes o dispositivos personalizados), se recomienda ponerse en contacto con nosotros al principio del proceso de desarrollo para ayudar a determinar el enfoque de integración más adecuado.
En caso de que encuentre problemas durante la implementación, le recomendamos que visite la guía de solución de problemas.
Compatibilidad con el SDK de llamada de iOS
- Compatibilidad con iOS 10.0+ en tiempo de compilación y iOS 12.0+ en tiempo de ejecución
- Xcode 12.0+
- Compatibilidad con iPadOS 13.0+
.NET
La llamada admite las siguientes plataformas:
- UWP con .NET Native o C++/WinRT
- Windows 10/11 10.0.17763 - 10.0.22621.0
- Windows Server 2019/2022 10.0.17763 - Windows Server 10.0.22621.0
- WinUI3 con .NET 6
- Windows 10/11 10.0.17763.0 - net6.0-windows10.0.22621.0
- Windows Server 2019/2022 10.0.17763.0 : net6.0-windows10.0.22621.0
Todos los demás paquetes de Communication Services tienen como destino .NET Standard 2.0, que admite las plataformas siguientes:
- Compatibilidad mediante .NET Framework 4.6.1
- Windows 10, 8.1, 8 y 7
- Windows Server 2012 R2, 2012 y 2008 R2 SP1
- Compatibilidad mediante .NET Core 2.0:
- Windows 10 (1607+), 7 SP1+, 8.1
- Windows Server 2008 R2 SP1 y versiones posteriores
- Max OS X 10.12+
- Varias versiones o distribuciones de Linux
- UWP 10.0.16299 (RS3) septiembre 2017
- Unity 2018.1
- Mono 5.4
- Xamarin iOS 10.14
- Xamarin Mac 3.8
Tamaño del paquete SDK
| SDK | Tamaño comprimido (MB) | Tamaño sin comprimir (MB) |
|---|---|---|
| SDK de iOS | ARM64 - 17,1 MB | ARM64 - 61,1 MB |
| SDK de Android | x86: 13.3 MB | x86: 33.75 MB |
| x86_64: 13.3 MB | x86_64: 35.75 MB | |
| ARM64-v8a : 13,1 MB | ARM64-v8a – 37,02 MB | |
| armeabi-v7a – 11,4 MB | armeabi-v7a – 23,97 MB |
Si desea mejorar la aplicación, le recomendamos que lea el artículo Procedimientos recomendados. Proporciona recomendaciones y una lista de comprobación para revisar antes de publicar la aplicación.
API de REST
Las API de Communication Services están documentadas junto con otras API REST de Azure. Esta documentación le indicará cómo estructurar los mensajes HTTP y ofrece instrucciones para el uso de Postman. La documentación de la interfaz de REST también se ofrece en formato Swagger en GitHub. Puede encontrar límites para las API individuales en la página de límites de servicio.
Expectativas de estabilidad de API
Importante
En esta sección se proporcionan instrucciones sobre las API DE REST y los SDK marcados como estables. Las API marcadas como versión preliminar o beta se pueden cambiar o dejar de usar sin previo aviso.
En el futuro, es posible que retiremos las versiones de los SDK de Communication Services y que introduzcamos cambios importantes en nuestras API de REST y SDK publicados. Azure Communication Services generalmente sigue dos directivas de compatibilidad para retirar versiones de servicio:
- Se le notifica al menos tres años antes de que sea necesario cambiar el código debido a un cambio de interfaz de Communication Services. Todas las API de REST documentadas y las API de los SDK generalmente disfrutan de un período de al menos tres años de advertencia antes de que se retiren las interfaces.
- Se le notificará al menos un año antes de tener que actualizar los ensamblados del SDK a la versión secundaria más reciente. Estas actualizaciones necesarias no deben requerir ningún cambio en el código porque están en la misma versión principal. El uso del SDK más reciente es sumamente importante para las bibliotecas de Calling y Chat que usan componentes en tiempo real que a menudo requieren actualizaciones de seguridad y rendimiento. Le recomendamos encarecidamente que mantenga actualizados todos los SDK de Communication Services.
Ejemplos de retirada de API y SDK
Ha integrado la versión 24 de la API de REST de SMS en la aplicación. Versiones de Azure Communication v25.
Recibirá tres años de advertencia antes de que estas API deje de funcionar y se obligue a actualizar a la versión 25. Es posible que esta actualización requiera un cambio de código.
Ha integrado la versión v2.02 del SDK de llamada en la aplicación. Versiones de Azure Communication v2.05.
Es posible que se le pida que actualice a la versión v2.05 de los SDK de llamadas en un plazo de 12 meses a partir de la publicación de la v2.05. Esta actualización debe ser un reemplazo sencillo del artefacto sin necesidad de un cambio de código porque la v2.05 está en la versión principal v2 y no tiene cambios importantes.
Pasos siguientes
Para obtener más información, consulte la siguiente información general de los SDK:
- Información general del SDK de llamada
- Información general sobre el SDK de automatización de llamadas
- Descripción general del SDK del enrutador de trabajos
- Información general del SDK de chat
- Información general del SDK de SMS
- Introducción al SDK de correo electrónico
- Introducción al SDK de mensajería avanzada
Para empezar a trabajar con Azure Communication Services: