Visão geral

Neste guia, você aprenderá como adicionar o Client SDK ao seu aplicativo para iOS.

Pré-requisitos

Para usar o SDK da Vonage para iOS, é necessário ter os seguintes itens instalados:

• Xcode
• iOS 13 ou versão posterior

Adicionando o Client SDK ao seu projeto iOS

O Vonage Client SDK para iOS é distribuído em três Client SDKs distintos. VonageClientSDKVoice para a funcionalidade de In-App Voice no aplicativo, VonageClientSDKChat para a funcionalidade de In-App Messaging, e combinadas como VonageClientSDK. VonageClientSDKChat não inclui a dependência do WebRTC, por isso é uma biblioteca menor. Você deve usar apenas um SDK por vez em seu aplicativo.

• In-App Voice e In-App Messaging - instalar VonageClientSDK apenas.

• In-App Voice - instalar VonageClientSDKVoice apenas.

• In-App Messaging - instalar VonageClientSDKChat apenas.

Você pode instalar o Client SDK por meio do Swift Package Manager ou do CocoaPods.

1. Depois de criar seu aplicativo no Xcode, clique em Arquivo > Adicionar dependências de pacotes...

2. Na caixa de pesquisa, cole a URL do Vonage Client SDK: https://github.com/Vonage/vonage-client-sdk-ios

3. Escolha sua regra de dependência; você pode especificar um intervalo de versões, uma versão exata ou o ramo principal.

4. Adicione a dependência; o Xcode fará o download do SDK. Quando terminar, escolha qual SDK adicionar.

Observação: Conforme mencionado anteriormente, você só pode incluir um Um SDK por vez.

5. Clique no seu destino de compilação no Xcode e vá para Configurações de compilação. Em seguida, procure por Outras opções do linker. Adicione o -ObjC marcar tanto para as configurações de depuração quanto para as de compilação.

Adicionar permissões (Voz)

Para usar os recursos de In-App Voice do aplicativo, é necessário conceder permissões de áudio:

1. No seu Info.plist adicione uma nova linha com “Privacidade – Descrição do uso do microfone” e uma descrição sobre como usar o microfone. Por exemplo, Audio Calls.

2. No seu código, adicione uma solicitação de permissões de áudio:

import AVFoundation

func askAudioPermissions() {
    AVAudioSession.sharedInstance().requestRecordPermission { granted in
        print("Allow microphone use. Response: ", granted)
    }
}

O AppDelegate é o melhor lugar para fazer isso.

Como usar o Client SDK em seu aplicativo

Agora que você instalou o Client SDK e solicitou as permissões de áudio, já pode começar a usá-lo.

Criar uma sessão

As sessões são um fluxo de comunicação em tempo real entre o Client SDK do cliente e os servidores da Vonage. Crie uma VGVonageClient objeto e, em seguida, criar uma sessão com um usuário JWT token.

let client = VGVonageClient()
client.delegate = self

client.createSession("JWT_TOKEN") { error, sessionId in
    ...
}

Se a criação da sessão for bem-sucedida, você receberá um ID de sessão. Observe que self deveria implementar o VGClientDelegate/VGVoiceClientDelegate/VGVoiceClientDelegate protocolos, dependendo do SDK que você instalou.

Status da sessão

Caso ocorram erros na sessão após ela ter sido criada com sucesso, você receberá essas informações na didReceiveSessionErrorWithReason função delegada no VGVoiceClientDelegate.

extension ViewController: VGClientDelegate {

    func client(_ client: VGBaseClient,
    didReceiveSessionErrorWith reason: VGSessionErrorReason) {
        // Session Error
    }

    ...
}

Conclusão

Você adicionou o Client SDK ao seu aplicativo para iOS e criou uma sessão. Agora você pode usar as funcionalidades do Client SDK.

Veja também

• Configuração do Data Center - essa é uma configuração opcional avançada que você pode realizar após adicionar o SDK ao seu aplicativo.