Swift

Fazer uma ligação

No topo do ViewController classe, logo abaixo do client declaração, adicione uma propriedade de tipo string para armazenar uma referência a qualquer chamada em andamento

class ViewController: UIViewController, NXMClientDelegate {
    ...
    let client = VGVoiceClient()
    var callID: String?
    ...
}

Com base na nulabilidade do callID propriedade, a callButtonPressed O método agora pode ser usado tanto para fazer quanto para encerrar chamadas; o placeCall e endCall Os métodos são acionados para cada caso.

Substitua o atual callButtonPressed método com o código abaixo:

@IBAction func callButtonPressed(_ sender: Any) {
    if callID == nil {
        placeCall()
    } else {
        endCall()
    }
}

func placeCall() {
    callButton.setTitle("End Call", for: .normal)
    client.serverCall(["to": "PHONE_NUMBER"]) { error, callId in
        DispatchQueue.main.async { [weak self] in
            guard let self else { return }
            if error == nil {
                self.callID = callId
            } else {
                self.callButton.setTitle("Call", for: .normal)
                self.connectionStatusLabel.text = error?.localizedDescription
            }
        }
    }
}

func endCall() {
    guard let callID else { return }
    client.hangup(callID) { error in
        DispatchQueue.main.async { [weak self] in
            guard let self else { return }
            if error == nil {
                self.callID = nil
                self.callButton.setTitle("Call", for: .normal)
            }
        }
    }
}

Ao fazer a ligação, o callServer função é chamada. Isso enviará as informações contidas no dicionário — neste caso, o número do destinatário — para o seu servidor de webhook. Seu webhook responderá com um objeto de controle de chamada, informando à Vonage a quem conectar sua chamada. Ao encerrar a chamada, o hangup a função é chamada, caso seja bem-sucedida callID é definido como nil.

NOTA: Certifique-se de substituir PHONE_NUMBER insira abaixo o número de telefone que você deseja ligar, no formato E.164 (por exemplo, 447700900000). Além disso, certifique-se de que o servidor de webhook que você configurou nas etapas anteriores ainda esteja em funcionamento.

É isso aí! Agora você pode criar, iniciar e fazer a ligação! Mágico! Assim que a ligação chegar, você pode atendê-la e ouvir a chamada de In-App Voice dentro do aplicativo.

Webhooks

À medida que você for realizando a ligação, por favor, mude para o terminal e observe o /voice/answer endpoint chamado para recuperar o NCCO:

NCCO request:
  - callee: 447700900000

Além disso, à medida que a chamada passa por várias etapas, /voice/event está recebendo eventos:

...
---
VOICE EVENT:
{
  from: null,
  to: 'Alice',
  uuid: '2da93da3-bcac-47ee-b48e-4a18fae7db08',
  conversation_uuid: 'CON-1a28b1f8-0831-44e6-8d58-42739e7d4c77',
  status: 'started',
  direction: 'inbound',
  timestamp: '2021-03-10T10:36:21.285Z'
}
---
VOICE EVENT:
{
  headers: {},
  from: 'Alice',
  to: '447700900000',
  uuid: '8aa86e22-8d45-4201-b8d8-3dcd76e76429',
  conversation_uuid: 'CON-1a28b1f8-0831-44e6-8d58-42739e7d4c77',
  status: 'started',
  direction: 'outbound',
  timestamp: '2021-03-10T10:36:27.080Z'
}
---
...
---
VOICE EVENT:
{
  start_time: null,
  headers: {},
  rate: null,
  from: 'Alice',
  to: '447700900000',
  uuid: '8aa86e22-8d45-4201-b8d8-3dcd76e76429',
  conversation_uuid: 'CON-1a28b1f8-0831-44e6-8d58-42739e7d4c77',
  status: 'answered',
  direction: 'outbound',
  network: null,
  timestamp: '2021-03-10T10:36:31.604Z'
}
---
VOICE EVENT:
{
  headers: {},
  end_time: '2021-03-10T10:36:36.000Z',
  uuid: '8aa86e22-8d45-4201-b8d8-3dcd76e76429',
  network: '23433',
  duration: '5',
  start_time: '2021-03-10T10:36:31.000Z',
  rate: '0.10000000',
  price: '0.00833333',
  from: 'Unknown',
  to: '447700900000',
  conversation_uuid: 'CON-1a28b1f8-0831-44e6-8d58-42739e7d4c77',
  status: 'completed',
  direction: 'outbound',
  timestamp: '2021-03-10T10:36:35.585Z'
}
---
VOICE EVENT:
{
  headers: {},
  end_time: '2021-03-10T10:36:35.000Z',
  uuid: '2da93da3-bcac-47ee-b48e-4a18fae7db08',
  network: null,
  duration: '15',
  start_time: '2021-03-10T10:36:20.000Z',
  rate: '0.00',
  price: '0',
  from: null,
  to: 'Alice',
  conversation_uuid: 'CON-1a28b1f8-0831-44e6-8d58-42739e7d4c77',
  status: 'completed',
  direction: 'inbound',
  timestamp: '2021-03-10T10:36:36.187Z'
}