Swift

Recibir una llamada

En la parte superior de la ViewController debajo de la clase client declaración, añade una propiedad de tipo cadena para almacenar una referencia a cualquier llamada en curso.

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

Cuando la aplicación reciba una llamada, querrás ofrecer la opción de aceptarla o rechazarla. Para ello, añade el displayIncomingCallAlert a la función ViewController clase.

class ViewController: UIViewController {
    ...
    func displayIncomingCallAlert(callID: String, caller: String) {
        let alert = UIAlertController(title: "Incoming call from", message: caller, preferredStyle: .alert)
        
        alert.addAction(UIAlertAction(title: "Answer", style: .default, handler: { _ in
            self.client.answer(callID) { error in
                if error == nil {
                    self.callID = callID
                }
            }
        }))
        
        alert.addAction(UIAlertAction(title: "Reject", style: .destructive, handler: { _ in
            self.client.reject(callID) { error in
                if let error {
                    self.connectionStatusLabel.text = error.localizedDescription
                }
            }
        }))
        
        self.present(alert, animated: true, completion: nil)
    }
}

El displayIncomingCallAlert La función toma como parámetros un ID de llamada y el nombre de la persona que llama. Ten en cuenta que en el UIAlertAction por responder a la invitación, si tiene éxito asignará el callID a la propiedad desde antes

Para utilizar displayIncomingCallAlert debe utilizar la función VGVoiceClientDelegate que tiene una función que se llamará cuando el cliente reciba una entrada VGVoiceInvite.

extension ViewController: VGVoiceClientDelegate {
  ...

  func voiceClient(_ client: VGVoiceClient, didReceiveInviteForCall callId: String, from caller: String, withChannelType type: VGVoiceChannelType) {
      DispatchQueue.main.async { [weak self] in
          self?.displayIncomingCallAlert(callID: callId, caller: caller)
      }
  }
  
  func voiceClient(_ client: VGVoiceClient, didReceiveInviteCancelForCall callId: String, with reason: VGVoiceInviteCancelReason) {
      DispatchQueue.main.async { [weak self] in
          self?.dismiss(animated: true)
      }
  }
  
  func voiceClient(_ client: VGVoiceClient, didReceiveHangupForCall callId: String, withQuality callQuality: VGRTCQuality, reason: VGHangupReason) {
      DispatchQueue.main.async { [weak self] in
          self?.callID = nil
          self?.connectionStatusLabel.text = "Call Ended"
      }
  }
}

También puede aplicar la función didReceiveHangupForCall función delegada que se ejecuta si se cuelga la llamada.

NOTA: Además, asegúrate de que el servidor de webhooks que has configurado en los pasos anteriores siga en funcionamiento.

Pulse Cmd + R Para volver a configurarlo y ponerlo en marcha, cuando llames al número vinculado a tu aplicación anterior, aparecerá una alerta. ¡Solo tienes que descolgar y la llamada se conectará!

Incoming call alert

Webhooks

A medida que avance en la llamada, por favor, cambie al terminal y fíjese en el /voice/answer punto final al que se realiza la llamada para recuperar el NCCO:

NCCO request:
  - caller: 441234567890

Además, a medida que la llamada avanza por las distintas fases, /voice/event se envían eventos:

EVENT:
{
  headers: {},
  from: '441234567890',
  to: '442038297050',
  uuid: '0779a56d002f1c7f47f82ef5fe84ab79',
  conversation_uuid: 'CON-8f5a100c-fbce-4218-8d4b-16341335bcd6',
  status: 'ringing',
  direction: 'inbound',
  timestamp: '2021-03-29T21:20:05.582Z'
}
---
EVENT:
{
  headers: {},
  from: '441234567890',
  to: '442038297050',
  uuid: '0779a56d002f1c7f47f82ef5fe84ab79',
  conversation_uuid: 'CON-8f5a100c-fbce-4218-8d4b-16341335bcd6',
  status: 'started',
  direction: 'inbound',
  timestamp: '2021-03-29T21:20:05.582Z'
}
---
EVENT:
{
  start_time: null,
  headers: {},
  rate: null,
  from: '441234567890',
  to: '442038297050',
  uuid: '0779a56d002f1c7f47f82ef5fe84ab79',
  conversation_uuid: 'CON-8f5a100c-fbce-4218-8d4b-16341335bcd6',
  status: 'answered',
  direction: 'inbound',
  network: null,
  timestamp: '2021-03-29T21:20:06.182Z'
}
---
EVENT:
{
  from: '441234567890',
  to: 'Alice',
  uuid: '944bf4bf-8dc7-4e23-86b2-2f4234777416',
  conversation_uuid: 'CON-8f5a100c-fbce-4218-8d4b-16341335bcd6',
  status: 'started',
  direction: 'outbound',
  timestamp: '2021-03-29T21:20:13.025Z'
}
---
EVENT:
{
  start_time: null,
  headers: {},
  rate: null,
  from: '441234567890',
  to: 'Alice',
  uuid: '944bf4bf-8dc7-4e23-86b2-2f4234777416',
  conversation_uuid: 'CON-8f5a100c-fbce-4218-8d4b-16341335bcd6',
  status: 'answered',
  direction: 'outbound',
  network: null,
  timestamp: '2021-03-29T21:20:13.025Z'
}
---
EVENT:
{
  headers: {},
  end_time: '2021-03-29T21:20:16.000Z',
  uuid: '944bf4bf-8dc7-4e23-86b2-2f4234777416',
  network: null,
  duration: '5',
  start_time: '2021-03-29T21:20:11.000Z',
  rate: '0.00',
  price: '0',
  from: '441234567890',
  to: 'Alice',
  conversation_uuid: 'CON-8f5a100c-fbce-4218-8d4b-16341335bcd6',
  status: 'completed',
  direction: 'outbound',
  timestamp: '2021-03-29T21:20:17.574Z'
}
---
EVENT:
{
  headers: {},
  end_time: '2021-03-29T21:20:18.000Z',
  uuid: '0779a56d002f1c7f47f82ef5fe84ab79',
  network: 'GB-FIXED',
  duration: '12',
  start_time: '2021-03-29T21:20:06.000Z',
  rate: '0.00720000',
  price: '0.00144000',
  from: ' 441234567890',
  to: '442038297050',
  conversation_uuid: 'CON-8f5a100c-fbce-4218-8d4b-16341335bcd6',
  status: 'completed',
  direction: 'inbound',
  timestamp: '2021-03-29T21:20:17.514Z'
}
---