Integrare CallKit nella libreria dell'interfaccia utente

Avvertimento

Servizi di comunicazione di Azure sta introducendo cambiamenti improvvisi e alcuni servizi stanno per essere ritirati. Scopri di più nella guida alla pensione e ai cambiamenti improvvisi.

La libreria dell'interfaccia utente di Servizi di comunicazione di Azure offre supporto predefinito per CallKit. Gli sviluppatori possono fornire la propria configurazione per CallKit da usare per la libreria dell'interfaccia utente.

Questo articolo illustra come configurare correttamente CallKit usando la libreria dell'interfaccia utente nell'applicazione.

Prerequisiti

Per altre informazioni, vedere la libreria dell'interfaccia utente iOS open source e il codice dell'applicazione di esempio.

Configurare l'integrazione di CallKit

L'SDK iOS di chiamata di Servizi di comunicazione di Azure supporta l'integrazione di CallKit. È possibile abilitare questa integrazione nella libreria dell'interfaccia utente configurando un'istanza di CallCompositeCallKitOption. Per altre informazioni, vedere Integrare con CallKit.

Specificare le informazioni sul destinatario delle chiamate in uscita

Per specificare le informazioni sulle chiamate in uscita, creare un'istanza di CallKitRemoteInfo. Se non fornisci CallKitRemoteInfo, viene visualizzato per impostazione predefinita il valore grezzo dell'identificatore del partecipante.

Assegnare un valore per displayName per personalizzare il nome visualizzato per il chiamante. Il valore specificato in CallKitRemoteInfo corrisponde esattamente a come appare nel registro delle chiamate dell’ultimo numero composto.

Assegnare anche il valore cxHandle. È ciò che l'applicazione riceve quando l'utente richiama il contatto.

let cxHandle = CXHandle(type: .generic, value: "VALUE_TO_CXHANDLE")
let callKitRemoteInfo = CallKitRemoteInfo(displayName: "DISPLAY_NAME", handle: cxHandle)
callComposite.launch(..., // Locator for Azure Communication Service
                     callKitRemoteInfo: callKitRemoteInfo)

Specificare le informazioni sul destinatario delle chiamate in arrivo

Per specificare le informazioni sul chiamante in ingresso, creare un'istanza di CallKitOptions. Se non specifichi CallKitOptions, per impostazione predefinita viene visualizzato il valore non elaborato dell'identificatore del partecipante.

Assegnare un valore per provideRemoteInfo per personalizzare il nome visualizzato per il chiamante. Il valore specificato in CallKitRemoteInfo corrisponde esattamente a come appare nel registro delle ultime chiamate effettuate.

Assegnare anche il valore cxHandle. È ciò che l'applicazione riceve quando l'utente richiama il contatto.

public func incomingCallRemoteInfo(info: Caller) -> CallKitRemoteInfo {
    let cxHandle = CXHandle(type: .generic, value: "VALUE_TO_CXHANDLE")
    var remoteInfoDisplayName = "DISPLAY_NAME"
    let callKitRemoteInfo = CallKitRemoteInfo(displayName: remoteInfoDisplayName,
                                                            handle: cxHandle)
    return callKitRemoteInfo
}

Configurare provider

Come richiesto, fornire un'istanza CXProviderConfiguration a CallKitOptions. Per altre informazioni, vedere la documentazione per sviluppatori Apple su CXProviderConfiguration.

let providerConfig = CXProviderConfiguration()
providerConfig.supportsVideo = true
providerConfig.maximumCallGroups = 1
providerConfig.maximumCallsPerCallGroup = 1
providerConfig.includesCallsInRecents = true
providerConfig.supportedHandleTypes = [.phoneNumber, .generic]

Configurare una sessione audio

Configurare una sessione audio da chiamare prima di effettuare o accettare la chiamata in ingresso e prima di riprendere una chiamata in attesa. Per altre informazioni, vedere la documentazione per sviluppatori Apple su AVAudioSession.

public func configureAudioSession() -> Error? {
    let audioSession = AVAudioSession.sharedInstance()
    let options: AVAudioSession.CategoryOptions = .allowBluetooth
    var configError: Error?
    do {
        try audioSession.setCategory(.playAndRecord)
    } catch {
        configError = error
    }
    return configError
}

Abilitare CallKit

Per abilitare CallKit, creare un'istanza di CallKitOptions e fornirla a callCompositeOptions.

let isCallHoldSupported = true // enable call hold (default is true)
let callKitOptions = CallKitOptions(
    providerConfig: providerConfig,
    isCallHoldSupported: isCallHoldSupported,
    provideRemoteInfo: provideRemoteInfo,
    configureAudioSession: configureAudioSession
)

let options = CallCompositeOptions(
    ..., // Other options for Azure Communication Service
    callKitOptions: callKitOptions
)

API per la messa in attesa e la ripresa di CallKit integrato nell'applicazione

Per CallKit integrato nell’applicazione usare hold e resume per gestire lo stato delle chiamate.

    callComposite.hold() { result in
        switch result {
            case .success:
                // success
            case .failure(let error):
                // failure
        }
    }

    callComposite.resume() { result in
        switch result {
            case .success:
                // success
            case .failure(let error):
                // failure
        }
    }

Passaggi successivi