Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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
- Un dispositivo iOS fisico. Un simulatore iOS non supporta la funzionalità CallKit.
- Un account Azure con una sottoscrizione attiva. Creare un account gratuitamente.
- Una risorsa di Servizi di comunicazione distribuita. Creare una risorsa di Servizi di comunicazione.
- Token di accesso utente per abilitare il client di chiamata. Ottenere un token di accesso utente.
- Facoltativo: completamento del QuickStart per iniziare a utilizzare i compositi della libreria dell'interfaccia utente.
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
}
}