Partilhar via

SDKs e REST APIs

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.

As tabelas a seguir resumem essas áreas e a disponibilidade de APIs REST e bibliotecas SDK. Observamos se as APIs e SDKs se destinam a clientes de usuários finais ou ambientes de serviços confiáveis. Você não deve acessar diretamente APIs como SMS usando dispositivos de usuário final em ambientes de baixa confiança.

Você pode acelerar o desenvolvimento de aplicativos de Chamada e Chat usando a 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 seis semanas ou uma vez por trimestre). Recomendamos a criação de um processo para garantir que você esteja sempre atualizando para os SDKs mais recentes.

SDKs

Assembleia Protocolos Ambiente 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 Gerencie usuários e tokens de acesso.
Números de telefone REST Serviço Adquira e gerencie números de telefone.
SMS REST Serviço Envie e receba mensagens SMS.
Correio eletrónico REST Serviço Envie e obtenha status em mensagens de e-mail.
Conversa REST com sinalização proprietária Cliente & Serviço Adicione chat de texto em tempo real às suas aplicações.
Telefonar Transporte próprio 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.
Gestor de Tarefas REST Serviço Otimize o gerenciamento de interações com clientes em vários aplicativos.
Quartos REST Serviço Crie e gerencie salas de comunicação estruturadas.
Biblioteca de UI 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 Envie e receba 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 - - Aceder via GitHub
Comum npm NuGet N/A Maven GitHub Maven -
Identidade npm NuGet PyPi Maven - - -
Números de Telefone npm NuGet PyPi Maven - - -
Conversa npm NuGet PyPi Maven GitHub Maven -
SMS npm NuGet PyPi Maven - - -
Correio eletrónico npm NuGet PyPi Maven - - -
Telefonar npm NuGet - - CocoaPods Maven -
Automação de chamadas npm NuGet PyPi Maven
Gestor de Tarefas npm NuGet PyPi Maven
Quartos npm NuGet PyPi Maven - - -
Biblioteca de UI 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 Descrição Assistência
Telemóveis e tablets Dispositivos padrão com Android Commercial. Suporte total para 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 padrão (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.

Se você encontrou problemas durante a implementação, consulte 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 função de chamadas 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-windows10.0.22621.0
    • Windows Server 2019/2022 10.0.17763.0 - net6.0-windows10.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+
    • Mac 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

Nota

Aplicativo não empacotado não é suportado no momento

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, consulte 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 descreve 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 OpenAPI no GitHub. Pode encontrar limites de restrição para APIs individuais em 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 precisar atualizar os assemblies do SDK para a versão menor 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.

Recebes um aviso de três anos antes que essas APIs parem de funcionar e és forçado a atualizar à 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 artefacto sem exigir uma alteração de código, pois a versão v2.05 está na grande versão v2 e não tem alterações disruptivas.

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: