SDKs e APIs REST
Os recursos dos Serviços de Comunicação do Azure são organizados conceitualmente em áreas discretas com base em sua área funcional. A maioria das áreas tem SDKs de código aberto totalmente programados em APIs REST publicadas que você pode usar diretamente pela Internet. O SDK de chamada usa interfaces de rede proprietárias e é de código fechado.
Nas tabelas abaixo, resumimos essas áreas e a disponibilidade de APIs REST e bibliotecas SDK. Observamos se as APIs e SDKs se destinam a clientes de usuário final ou ambientes de serviço confiáveis. APIs como SMS não devem ser acessadas diretamente por dispositivos de usuários finais em ambientes de baixa confiança.
O desenvolvimento de aplicativos de Chamada e Chat pode ser acelerado pela biblioteca de interface do usuário dos Serviços de Comunicação do Azure. A biblioteca de interface do usuário personalizável fornece componentes de interface do usuário de código aberto para aplicativos Web e móveis e um tema do Microsoft Teams.
SDKs
| Assemblagem | Protocolos | Environment | Capacidades |
|---|---|---|---|
| Azure Resource Manager | REST | Serviço | Provisionar e gerenciar recursos de Serviços de Comunicação |
| Comum | N/A | Cliente & Serviço | Fornece tipos básicos para outros SDKs |
| Identidade | REST | Serviço | Gerenciar usuários, acessar tokens |
| Números de telefone | REST | Serviço | Adquira e gerencie números de telefone |
| SMS | REST | Serviço | Enviar e receber mensagens SMS |
| REST | Serviço | Enviar e obter status em mensagens de e-mail | |
| Chat | REST com sinalização proprietária | Cliente & Serviço | Adicione chat de texto em tempo real às suas aplicações |
| Telefonar | Transporte proprietário | Cliente | Voz, vídeo, compartilhamento de tela e outras comunicações em tempo real |
| Automação de chamadas | REST | Serviço | Crie fluxos de trabalho de chamadas personalizados para chamadas PSTN e VoIP |
| Roteador de trabalho | REST | Serviço | Otimize o gerenciamento de interações com clientes em vários aplicativos |
| Travessia de Rede | REST | Serviço | Acesse servidores TURN para transporte de dados de baixo nível |
| Rooms | REST | Serviço | Criar e gerenciar salas de comunicação estruturadas |
| Biblioteca da interface do usuário | N/A | Cliente | Componentes de interface do usuário prontos para produção para aplicativos de bate-papo e chamada |
Idiomas e locais de publicação
Os locais de publicação para pacotes SDK individuais são detalhados abaixo.
| Área | JavaScript | .NET | Python | Java SE | iOS | Android | Outro |
|---|---|---|---|---|---|---|---|
| Azure Resource Manager | npm | NuGet | PyPi | Maven | - | - | Ir via GitHub |
| Comum | npm | NuGet | N/A | Maven | GitHub | Maven | - |
| Identidade | npm | NuGet | PyPi | Maven | - | - | - |
| Números de Telefone | npm | NuGet | PyPi | Maven | - | - | - |
| Chat | npm | NuGet | PyPi | Maven | GitHub | Maven | - |
| SMS | npm | NuGet | PyPi | Maven | - | - | - |
| npm | NuGet | PyPi | Maven | - | - | - | |
| Telefonar | npm | NuGet | - | - | CacauPods | Maven | - |
| Automação de chamadas | npm | NuGet | PyPi | Maven | |||
| Roteador de trabalho | npm | NuGet | PyPi | Maven | |||
| Travessia de Rede | npm | NuGet | PyPi | Maven | - | - | - |
| Rooms | npm | NuGet | PyPi | Maven | - | - | - |
| Biblioteca da interface do usuário | npm | - | - | - | GitHub | GitHub | GitHub, Livro de histórias |
| Mensagens avançadas | - | NuGet | - | - | - | - | - |
| Documentação de Referência | documentos | documentos | documentos | documentos | documentos | documentos | - |
Detalhes de suporte da plataforma SDK
Suporte ao Android Calling SDK
- Suporte para Android API Nível 21 ou superior
- Suporte para Java 7 ou superior
- Suporte para Android Studio 2.0
- Dispositivos Android Auto (AAOS) e IoT com Android não são suportados no momento
Suporte ao iOS Calling SDK
- Suporte para iOS 10.0+ em tempo de compilação e iOS 12.0+ em tempo de execução
- Xcode 12.0+
- Suporte para iPadOS 13.0+
.NET
A chamada suporta as plataformas listadas abaixo.
- UWP com .NET nativo ou C++/WinRT
- Windows 10/11 10.0.17763 - 10.0.22621.0
- Windows Server 2019/2022 10.0.17763 - 10.0.22621.0
- WinUI3 com .NET 6
- Windows 10/11 10.0.17763.0 - net6.0-janelas10.0.22621.0
- Windows Server 2019/2022 10.0.17763.0 - net6.0-janelas10.0.22621.0
Todos os outros pacotes de Serviços de Comunicação destinam-se ao .NET Standard 2.0, que suporta as plataformas listadas abaixo.
- Suporte via .NET Framework 4.6.1
- Windows 10, 8.1, 8 e 7
- Windows Server 2012 R2, 2012 e 2008 R2 SP1
- Suporte via .NET Core 2.0:
- Windows 10 (1607+), 7 SP1+, 8.1
- Windows Server 2008 R2 SP1+
- Máximo OS X 10.12+
- Linux múltiplas versões/distribuições
- UWP 10.0.16299 (RS3) setembro 2017
- Unidade 2018.1
- Mono 5,4
- Xamarin iOS 10.14
- Xamarin Mac 3.8
APIs REST
As APIs dos Serviços de Comunicação são documentadas juntamente com outras APIs REST do Azure. Esta documentação irá dizer-lhe como estruturar as suas mensagens HTTP e oferece orientação para a utilização do Postman. A documentação da interface REST também é publicada no formato Swagger no GitHub. Você pode encontrar limites de limitação para APIs individuais na página de limites de serviço.
Expectativas de estabilidade da API
Importante
Esta seção fornece orientação sobre APIs REST e SDKs marcados como estáveis. As APIs marcadas como pré-lançamento, visualização ou beta podem ser alteradas ou preteridas sem aviso prévio.
No futuro, poderemos desativar versões dos SDKs dos Serviços de Comunicação e introduzir alterações significativas em nossas APIs REST e SDKs lançados. Os Serviços de Comunicação do Azure geralmente seguirão duas políticas de suporte para desativar versões de serviço:
- Você será notificado pelo menos três anos antes de ser solicitado a alterar o código devido a uma alteração na interface dos Serviços de Comunicação. Todas as APIs REST e SDK documentadas geralmente desfrutam de pelo menos três anos de aviso antes que as interfaces sejam descomissionadas.
- Você será notificado pelo menos um ano antes de ter que atualizar os assemblies do SDK para a versão secundária mais recente. Essas atualizações necessárias não devem exigir nenhuma alteração de código porque estão na mesma versão principal. Usar o SDK mais recente é especialmente importante para as bibliotecas de Chamada e Bate-papo que são componentes em tempo real que geralmente exigem atualizações de segurança e desempenho. Recomendamos vivamente que mantenha todos os seus SDKs de Serviços de Comunicação atualizados.
Exemplos de descomissionamento de API e SDK
Você integrou a versão v24 da API REST SMS em seu aplicativo. O Azure Communication lança a v25.
Você receberá um aviso de três anos antes que essas APIs parem de funcionar e sejam forçadas a atualizar para a v25. Esta atualização pode exigir uma alteração de código.
Você integrou a versão v2.02 do SDK de chamada em seu aplicativo. O Azure Communication lança a v2.05.
Pode ser necessário atualizar para a versão v2.05 do SDK de chamada dentro de 12 meses após o lançamento da v2.05. Esta deve ser uma substituição simples do artefato sem exigir uma alteração de código porque v2.05 está na versão principal v2 e não tem alterações de quebra.
Próximos passos
Para obter mais informações, consulte as seguintes visões gerais do SDK:
- Visão geral do SDK de chamada
- Visão geral do SDK de automação de chamadas
- Visão geral do SDK do Job Router
- Visão geral do SDK de bate-papo
- Visão geral do SDK do SMS
- Visão geral do SDK de e-mail
Para começar a usar os Serviços de Comunicação do Azure: