You are viewing the Portuguese (Brazil) site, but your language preference is set to English. Switch to English site →

Menu

Expand
Classifique esta página:

SDK para iOS

O SDK para iOS do Twilio Programmable Voice permite adicionar chamadas de voz sobre IP (VoIP) a seus aplicativos nativos do iOS.

Aviso de compatibilidade do iOS 14

Para compatibilidade com o iOS 14, atualize para o SDK do Voice iOS 5.5.1 mais recente.

Aviso de compatibilidade do iOS 13

Apps que usam as versões 2.0.x, 3.x e 4.x podem não conseguir se registrar para chamadas recebidas quando executados no iOS 13. Recomendamos que você atualize para a versão 5.0. Consulte este comunicado e este problema do GitHub para obter mais informações. Verifique nossos guias de migração ao planejar sua migração para nosso SDK mais recente.

Para obter instruções passo a passo e começar a trabalhar com o SDK para iOS do Programmable Voice, confira os inícios rápidos para fazer chamadas dos seus apps nativos do iOS no Objective-C e no Swift.

Os SDKs do Programmable Voice são liberados de acordo com o controle de versão semântica; portanto, você deve sempre observar as versões principais e secundárias dos SDKs para manter a compatibilidade da API com seu código. Para as versões 1.0 e superiores, as versões secundárias não interrompem as integrações existentes, mas durante um período beta, os incrementos de versões secundárias no intervalo 0.x representam alterações significativas da API. As versões de nível de patch, 0.0.x, representam alterações incondicionais durante uma versão beta.

Autenticação/autorização

Nos SDKs do Programmable Voice, usamos um novo mecanismo de autenticação/autorização do servidor de aplicativos para dar aos seus clients acesso aos seus aplicativos do Voice. Isso é feito fornecendo ao seu app um Access Token (Token de acesso) que regula a sessão de autenticação do aplicativo do client (cliente) com sua account (conta) na nuvem do Twilio. Os Access Tokens (tokens de acesso) são diferentes dos Tokens de recursos usados nas versões anteriores do Twilio Client. O uso de um Token de recursos no SDK Programmable Voice não funcionará. Os Access Tokens (tokens de acesso), assim como os tokens de recursos antes, são tokens JWT, mas estão usando um novo formato mais flexível que é usado em todos os novos SDKs da Twilio.

Console de gerenciamento

As ferramentas do desenvolvedor e as opções de configuração para Programmable Voice podem ser encontradas no Dashboard do Programmable Voice. Use o console para criar apps TwiML, atualizar credenciais de push, visualizar registros e muito mais.

Os SDKs do Programmable Voice são liberados de acordo com o controle de versão semântica; portanto, você deve sempre observar as versões principal e secundária dos SDKs para manter a compatibilidade da API com seu código. Para as versões 1.0 e superiores, as versões secundárias não interrompem as integrações existentes, mas durante um período beta, os incrementos de versões secundárias no intervalo 0.x representam alterações significativas da API. As versões de nível de patch, 0.0.x, representam alterações incondicionais durante uma versão beta.

Pré‐requisitos

– Xcode 12.0+ – Os projetos Swift devem usar Swift 4.0 ou superior – Suporte para iOS 11.0 ou superior

Instalação

A estrutura do Voice para iOS pode ser instalada usando Swift Package Manager, CocoaPods, Carthage ou manualmente, como preferir.

Swift Package Manager

Você pode adicionar o Programmable Voice para iOS acrescentando o repositório "https://github.com/twilio/twilio-voice-ios" como um pacote Swift.

Em suas Build Settings, você também precisará modificar "Other Linker Flags" para incluir "-ObjC".

A partir da versão mais recente do Xcode (atualmente 12.4), há um problema conhecido com o consumo de estruturas binárias distribuídas via Swift Package Manager. A solução alternativa atual para este problema é adicionar uma "Run Script Phase" ao "Build Phases" do seu projeto Xcode. Essa "Run Script Phase" deverá vir após a fase de criação "Embed Frameworks". Essa nova "Run Script Phase" deve conter o seguinte código:

find "${CODESIGNING_FOLDER_PATH}" -name '*.framework' -print0 | while read -d $'\0' framework
do
    codesign --force --deep --sign "${EXPANDED_CODE_SIGN_IDENTITY}" --preserve-metadata=identifier,entitlements --timestamp=none "${framework}"
done

CocoaPods

É fácil instalar a estrutura do Voice se você gerenciar suas dependências usando CocoaPods. Basta adicionar o seguinte ao seu "Podfile":

origem 'https://github.com/cocoapods/specs'

destino 'TARGET_NAME' do
  use_frameworks!

  pod 'TwilioVoice', '~> 6.4.1'
end

Então execute "pod install --verbose" para instalar as dependências do seu projeto.

Carthage

Damos suporte à integração usando estruturas binárias Carthage. Adicione o SDK para iOS do Voice incluindo a seguinte linha ao seu "Cartfile":

binário "https://raw.githubusercontent.com/twilio/twilio-voice-ios/Releases/twilio-voice-ios.json"

Em seguida, execute "carthage bootstrap --use-xcframeworks" (ou "carthage update --use-xcframeworks" se estiver atualizando seus SDKs)

Na guia General settings (Configurações gerais) do destino do aplicativo, na seção "Frameworks, Libraries, and Embedded Content", arraste e solte o "TwilioVoice.xcframework" da pasta Carthage/Build no disco.

Instalação manual

O "TwilioVoice.xcframework" é distribuído como uma estrutura dinâmica para iOS que você arrasta e solta em seus projetos existentes.

Depois de baixar e descompactar o XCFramework, navegue até a página de configurações General do seu projeto Xcode. Arraste e solte o "TwilioVoice.xcframework" na seção Frameworks, Libraries, and Embedded Content. Verifique se a opção "Copy items if needed" está marcada e pressione Finish. Certifique‐se de que a opção "Embed & Sign" esteja selecionada.

Em suas Build Settings, você também precisará modificar "Other Linker Flags" para incluir "-ObjC".

Recomendamos que você comece com nosso Guia de introdução para ter uma ideia de como todos esses componentes se encaixam. O app de início rápido é configurado para gerenciar dependências com CocoaPods, mas você também pode instalar as estruturas manualmente, conforme descrito acima.

Carthage

Carthage atualmente não é um mecanismo de distribuição compatível com o Twilio Voice. O Carthage não funciona atualmente com o ".xcframeworks" conforme documentado aqui. Assim que o Carthage for compatível com ".xcframeworks" binário, a distribuição do Carthage será adicionada novamente.

Biblioteca estática

O Voice também está disponível como uma biblioteca estática.

Depois de baixar a biblioteca estática, arraste e solte as pastas "libTwilioVoice.a", "libboringssl.a" e "include" no seu projeto Xcode. Isso adicionará as bibliotecas estáticas à seção Frameworks, Libraries, and Embedded Contents.

Há mais algumas coisas que você terá que adicionar para criar a biblioteca com seu app:

– Adicione "-ObjC" a Other Linker Flags – Adicione essas estruturas à seção Linked Frameworks and Libraries: "SystemConfiguration", "AudioToolbox", "AVFoundation", "CoreTelephony", "PushKit" e "CallKit".

Classifique esta página:

Precisa de ajuda?

Às vezes, todos nós precisamos; a programação é difícil. Receba ajuda agora da nossa equipe de suporte, ou confie na sabedoria da multidão navegando pelo Stack Overflow Collective da Twilio ou buscando a tag Twilio no Stack Overflow.

        
        
        

        Obrigado pelo seu feedback!

        Selecione o(s) motivo(s) para seu feedback. As informações adicionais que você fornece nos ajudam a melhorar nossa documentação:

        Enviando seu feedback...
        🎉 Obrigado pelo seu feedback!
        Algo deu errado. Tente novamente.

        Obrigado pelo seu feedback!

        thanks-feedback-gif