Apresentamos os novos SDKs do cliente Vonage para Android e iOS

O Vonage Client SDK tem um novo nome de pacote! Junto com esse novo nome, vem uma nova versão principal com muitos novos recursos e correções. Nos bastidores, o SDK agora utiliza o Kotlin Multiplatform para compartilhar o código das funcionalidades essenciais entre os SDKs nativos do Android e do iOS

Vamos ver como você pode começar a usar o SDK.

Incorporando o SDK

Conforme mencionado, o SDK agora tem um novo nome. Para adicioná-lo ao seu aplicativo, você precisa fazer o seguinte:

Android

Adicione a dependência ao build.gradle :

implementation 'com.vonage:client-sdk-voice'

iOS

Adicione a dependência ao Podfile:

pod 'VonageClientSDKVoice'

Concepts-chave

Ao trabalhar com o SDK, há alguns Concepts com os quais você precisará se familiarizar.

Sessão

Uma sessão é um fluxo de comunicação em tempo real entre o SDK e os servidores da Vonage. Você pode saber mais sobre como criar uma sessão mais adiante neste blog.

Convidar

Um convite é enviado ao SDK quando o usuário atual é convidado a participar de uma chamada. A função de ouvinte/delegado do convite contém as informações necessárias sobre a chamada. Os convites podem ser aceitos ou rejeitados.

Ligar

Depois de aceitar um convite com sucesso, você receberá um ID de chamada. Esse ID permite que você faça alterações na chamada de voz usando as funções disponíveis. Por exemplo, desligar a chamada, silenciar a chamada ou usar a função de conversão de texto em fala, entre outras.

Perna

Um trecho é uma conexão entre um usuário e uma chamada; a cada trecho é atribuído um ID. Uma chamada é composta por vários trechos. Portanto, no caso de dois usuários do SDK estarem em uma chamada, a conexão entre o Usuário A e a Vonage seria o trecho 1, e a conexão entre o Usuário B e a Vonage seria o trecho 2. A chamada seria, assim, formada pelos trechos 1 e 2.

Criação de uma sessão

Agora que você já entendeu os Concepts-chave, vamos ver como usar o SDK. Antes de fazer uma chamada, é preciso criar uma sessão. Você pode criar uma sessão usando a createSession função.

Android

val config = ClientConfig(ConfigRegion.US) 
val client = VoiceClient(this.application.applicationContext)
client.setConfig(config)

client.createSession("JWT") { err, sessionID ->
    if err == null {
    // Connected!
    }
}

iOS

let config = VGClientConfig(region: .US) 
let client = VGVoiceClient()
client.setConfig(config)

client.createSession("JWT") { error, sessionID in
    if error == nil {
    // Connected!
    }
}

Essa função recebe um JWT para identificar a qual usuário a sessão pertenceria. Confira o Guia do JWT para obter mais informações sobre como criar JWTs para uso com o Client SDK.

Fazendo uma ligação

Depois de criar uma sessão com sucesso, você já pode fazer uma chamada usando a serverCall função:

Android

client.serverCall(mapOf("to" to "CALLEE")) { err, callID ->
    if err == null {
    // Connected to the call!
    }
}

iOS

client.serverCall(["to": "CALLEE"]) { error, callID in
    if error == nil {
    // Connected to the call!
    }
}

serverCall envia uma solicitação HTTP (por meio dos servidores da Vonage) para a URL de resposta especificada no seu aplicativo da Vonage. Sua URL de resposta deve retornar com um Objeto de Controle de Chamada informando à Vonage como lidar com a chamada.

Receber uma ligação

Vamos ver como fica do outro lado, quando você estiver recebendo uma ligação:

Android

No Android, você pode definir o ouvinte de convite de chamada, que será executado quando o SDK receber um convite:

client.setCallInviteListener { callId, from, channelType ->
    client.answer(it) { err ->
        if err == null {
        // Connected to the call!
        }
    }
}

iOS

No iOS, certifique-se de definir o VGVoiceClientdelegado usando client.delegate = self primeiro. Quando o SDK receber um convite, a didReceiveInviteForCall função no VGVoiceClientDelegate será chamada:

func voiceClient(_ client: VGVoiceClient, didReceiveInviteForCall callId: String, from caller: String, withChannelType type: String) {
    client.answer(callId) { error in
        if error == nil {
        // Connected to the call!
        }
    }
}

Notificações push

O novo Vonage Client SDK tornou as notificações push a forma padrão de receber chamadas, para garantir que todas as chamadas sejam recebidas pelos dispositivos, independentemente de seu aplicativo estar em primeiro plano ou não. Para que esse comportamento ocorra, você precisará habilitar os convites via WebSocket na configuração do seu cliente:

config.enableWebsocketInvites = true

Para obter informações mais detalhadas sobre como configurar notificações push para o Vonage Client SDK, consulte os novos guias de Notificações Push para Android e iOS.

E agora?

Saiba mais sobre o Vonage Client SDK em developer.vonage.com, onde você pode experimentar o tutorial passo a passo sobre como fazer chamadas de saída.