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.
Criando uma prática para usar o SDK mais recente
Os navegadores e sistemas operacionais estão em constante evolução para suportar os aprimoramentos mais recentes e corrigir bugs existentes. Usar o SDK mais recente dos Serviços de Comunicação do Azure pode ajudá-lo a obter a melhor experiência geral do usuário final para seu aplicativo quando usado com navegadores atualizados e atualizações do sistema operacional. O SDK dos Serviços de Comunicação do Azure mais atualizado oferece muitos benefícios, como melhor desempenho, segurança, compatibilidade, qualidade e usabilidade. A atualização permite-lhe aceder às mais recentes funcionalidades e atualizações que são regularmente adicionadas ao navegador e ao sistema operativo. Os SDKs dos Serviços de Comunicação do Azure são atualizados com frequência (aproximadamente a cada 6 semanas a uma vez por trimestre). É aconselhável que você crie um processo para garantir que está sempre atualizando para os SDKs mais recentes.
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 |
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 |
Mensagens avançadas | REST | Serviço | Enviar e receber mensagens do WhatsApp Business |
Idiomas e locais de publicação
Locais de publicação para pacotes SDK individuais:
Á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 | |||
Rooms | npm | NuGet | PyPi | Maven | - | - | - |
Biblioteca da interface do usuário | npm | - | - | - | GitHub | GitHub | GitHub, Livro de histórias |
Mensagens avançadas | npm | NuGet | PyPi | Maven | - | - | - |
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
Suporte à plataforma Android
O ecossistema Android é extenso, englobando várias versões e plataformas especializadas projetadas para diversos tipos de dispositivos. A tabela seguinte lista as plataformas Android atualmente suportadas:
Dispositivos | Description | Suporte |
---|---|---|
Telemóveis e tablets | Dispositivos padrão com Android Commercial. | Suporte total com a resolução de vídeo. |
Nota
Só suportamos videochamadas em telemóveis e tablets. Para casos de uso envolvendo vídeo em dispositivos ou plataformas não padronizados (como óculos inteligentes ou dispositivos personalizados), sugerimos entrar em contato conosco no início do seu processo de desenvolvimento para ajudar a determinar a abordagem de integração mais adequada.
Caso tenha encontrado problemas durante a implementação, recomendamos que visite o guia de solução de problemas.
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 seguintes plataformas:
- 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 seguintes plataformas:
- 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
Tamanho do pacote SDK
SDK | Tamanho comprimido (MB) | Tamanho não comprimido (MB) |
---|---|---|
SDK do iOS | ARM64 - 17,1 MB | ARM64 - 61,1 MB |
SDK do 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 |
Se você quiser melhorar seu aplicativo, sugerimos que leia o artigo Práticas recomendadas. Ele fornece recomendações e uma lista de verificação para revisar antes de lançar seu aplicativo.
APIs REST
As APIs dos Serviços de Comunicação são documentadas juntamente com outras APIs REST do Azure. Esta documentação informa como estruturar suas mensagens HTTP e oferece orientação para o uso 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 seguem duas políticas de suporte para desativar versões de serviço:
- Você é 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ê é 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ê recebe 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. A atualização deve ser uma substituição 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
- Visão geral do SDK de mensagens avançadas
Para começar a usar os Serviços de Comunicação do Azure: