Partilhar via


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
E-mail 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 - - -
E-mail 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:

Para começar a usar os Serviços de Comunicação do Azure: