Instalação

Instale o Client SDK para a sua plataforma de destino antes de criar uma sessão.

Requisitos da plataforma

Plataforma Versão mínima Permissões necessárias
Android SDK 23 (Android 6.0) INTERNET, RECORD_AUDIO
iOS iOS 15.0 Uso do microfone (NSMicrophoneUsageDescription (no arquivo Info.plist)
Web Navegadores modernos compatíveis com WebRTC (Chrome 70 ou superior, Firefox 60 ou superior, Safari 14.1 ou superior, Edge 79 ou superior) Acesso ao microfone (solicitado pelo navegador)

Aviso: Fixação de versão no ambiente de produção Os exemplos a seguir utilizam latest.release (Android) e @latest (CDN) por uma questão de simplicidade. Em aplicativos de produção, sempre especifique uma versão específica (por exemplo, com.vonage:client-sdk-voice:2.3.1 ou @vonage/client-sdk@2.3.1) para garantir compilações reproduzíveis e evitar alterações inesperadas que causem falhas na atualização. Verifique o Registro de alterações para consultar as notas de lançamento antes de atualizar.

NPM

Instale usando o gerenciador de pacotes de sua preferência:

npm i @vonage/client-sdk # or yarn add @vonage/client-sdk # or pnpm add @vonage/client-sdk # or bun add @vonage/client-sdk

Em seguida, importe o Client SDK:

import clientSDK from '@vonage/client-sdk';

CDN

<script src="https://cdn.jsdelivr.net/npm/@vonage/client-sdk@latest/dist/vonageClientSDK.min.js"></script>

Acesso ao microfone

O navegador solicitará permissão para usar o microfone ao usuário quando uma chamada for iniciada. Não é necessário nenhum manifesto nem configuração, mas a página deve ser servida por HTTPS (ou localhost) para getUserMedia estar disponível.

  1. Certifique-se de que o Maven Central esteja disponível em seus repositórios:
dependencyResolutionManagement {
    repositories {
        mavenCentral()
    }
}
  1. Adicione a dependência do Voice SDK:
dependencies {
    implementation("com.vonage:client-sdk-voice:latest.release")
}
  1. Adicione as permissões necessárias ao seu AndroidManifest.xml:
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />

Você também deve solicitar RECORD_AUDIO em tempo de execução, antes de fazer ou atender chamadas (Android 6.0+).

CocoaPods

Adicione o Client SDK ao seu Podfile:

target 'YourApp' do
  use_frameworks!
  pod 'VonageClientSDKVoice'
end

Swift Package Manager

  1. No Xcode, selecione Arquivo -> Adicionar dependências de pacotes...
  2. Uso https://github.com/Vonage/vonage-client-sdk-ios
  3. Escolha sua regra de versão e adicione o pacote ao seu destino

Linker Flag

Conjunto -ObjC no seu alvo Configurações de compilação -> Outras opções do vinculador (Depuração e Lançamento).

Microphone Permission

Adicione a descrição do uso do microfone ao seu Info.plist:

<key>NSMicrophoneUsageDescription</key>
<string>Required for voice calls</string>

Sem essa configuração, o iOS encerrará seu aplicativo quando o SDK solicitar acesso ao microfone.