Интеграция с CallKit

В этом документе мы рассмотрим, как интегрировать CallKit с приложением iOS.

Предпосылки

• Учетная запись Azure с активной подпиской. Создайте учетную запись бесплатно .
• Ресурс служб связи, находящийся в эксплуатации. Создайте ресурс служб коммуникации.
• Маркер доступа пользователя для включения клиента для вызовов. Дополнительные сведения см. в статье о создании маркеров доступа и управлении ими.
• Необязательно. Выполните краткое руководство по добавлению голосовых вызовов в приложение

Интеграция CallKit (в пакете SDK)

Интеграция CallKit в пакете SDK для служб коммуникации Azure для iOS обрабатывает взаимодействие с CallKit для нас. Для выполнения любых операций вызова, таких как заглушить/восстановить звук, удержание и возобновление, необходимо вызвать API в SDK служб коммуникации Azure.

Инициализация агента вызова с помощью CallKitOptions

С настроенным экземпляром CallKitOptions мы можем создать CallAgent, который будет обрабатывать CallKit.

let options = CallAgentOptions()
let callKitOptions = CallKitOptions(with: createProviderConfig())
options.callKitOptions = callKitOptions

// Configure the properties of `CallKitOptions` instance here

self.callClient!.createCallAgent(userCredential: userCredential,
    options: options,
    completionHandler: { (callAgent, error) in
    // Initialization
})

Указание сведений о получателе звонков для исходящих звонков

Сначала необходимо создать экземпляр StartCallOptions() для исходящих вызовов или JoinCallOptions() для группового вызова.

let options = StartCallOptions()

или

let options = JoinCallOptions()

Затем создайте экземпляр CallKitRemoteInfo

options.callKitRemoteInfo = CallKitRemoteInfo()

1. Назначьте значение callKitRemoteInfo.displayNameForCallKit для настройки отображаемого имени получателей звонков и задайте значение CXHandle. Это значение, указанное в displayNameForCallKit, отображается именно так, как в журнале последнего набранного номера. в журнале последних набранных звонков.

options.callKitRemoteInfo.displayNameForCallKit = "DISPLAY_NAME"

2. Значение cxHandle — это то, что приложение получает, когда пользователь перезванивает по этому контакту.

options.callKitRemoteInfo.cxHandle = CXHandle(type: .generic, value: "VALUE_TO_CXHANDLE")

Указание сведений о получателе звонка для входящих вызовов

Сначала необходимо создать экземпляр CallKitOptions:

let callKitOptions = CallKitOptions(with: createProviderConfig())

Настройте свойства экземпляра CallKitOptions :

Блок, который передается переменной provideRemoteInfo, будет вызван SDK при получении входящего вызова, и нам нужно получить отображаемое имя звонящего, которое необходимо передать в CallKit.

callKitOptions.provideRemoteInfo = self.provideCallKitRemoteInfo

func provideCallKitRemoteInfo(callerInfo: CallerInfo) -> CallKitRemoteInfo
{
    let callKitRemoteInfo = CallKitRemoteInfo()
    callKitRemoteInfo.displayName = "CALL_TO_PHONENUMBER_BY_APP"      
    callKitRemoteInfo.cxHandle = CXHandle(type: .generic, value: "VALUE_TO_CXHANDLE")
    return callKitRemoteInfo
}

Настройка звукового сеанса

Процесс настройки аудиосеанса будет вызван перед размещением или принятием входящего вызова и перед возобновлением вызова после удержания.

callKitOptions.configureAudioSession = self.configureAudioSession

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

ПРИМЕЧАНИЕ. В случаях, когда компания Contoso уже настроила звуковые сеансы, НЕ предоставляйте nil, но возвращайте ошибку nil в блоке.

callKitOptions.configureAudioSession = self.configureAudioSession

public func configureAudioSession() -> Error? {
    return nil
}

Если nil предоставлен для configureAudioSession, пакет SDK вызывает реализацию по умолчанию.

Обработка данных входящих push-уведомлений

Когда приложение получает входящее push-уведомление, необходимо вызвать handlePush для его обработки. Пакет SDK служб коммуникации Azure для вызовов будет генерировать событие IncomingCall.

public func handlePushNotification(_ pushPayload: PKPushPayload)
{
    let callNotification = PushNotificationInfo.fromDictionary(pushPayload.dictionaryPayload)
    if let agent = self.callAgent {
        agent.handlePush(notification: callNotification) { (error) in }
    }
}

// Event raised by the SDK
public func callAgent(_ callAgent: CallAgent, didReceiveIncomingCall incomingcall: IncomingCall) {
}

Мы можем использовать reportIncomingCall для обработки push-уведомлений при закрытии приложения или в противном случае.

if let agent = self.callAgent {
  /* App is not in a killed state */
  agent.handlePush(notification: callNotification) { (error) in }
} else {
  /* App is in a killed state */
  CallClient.reportIncomingCall(with: callNotification, callKitOptions: callKitOptions) { (error) in
      if (error == nil) {
          DispatchQueue.global().async {
              self.callClient = CallClient()
              let options = CallAgentOptions()
              let callKitOptions = CallKitOptions(with: createProviderConfig())
              callKitOptions.provideRemoteInfo = self.provideCallKitRemoteInfo
              callKitOptions.configureAudioSession = self.configureAudioSession
              options.callKitOptions = callKitOptions
              self.callClient!.createCallAgent(userCredential: userCredential,
                  options: options,
                  completionHandler: { (callAgent, error) in
                  if (error == nil) {
                      self.callAgent = callAgent
                      self.callAgent!.handlePush(notification: callNotification) { (error) in }
                  }
              })
          }
      } else {
          os_log("SDK couldn't handle push notification", log:self.log)
      }
  }
}

Интеграция CallKit (в приложении)

Если вы хотите интегрировать CallKit в приложение и не использовать реализацию CallKit в пакете SDK, ознакомьтесь с примером краткого руководства, который доступен здесь. Но одной из важных задач является обеспечение того, чтобы аудио начиналось в нужное время. Как показано ниже

let outgoingAudioOptions = OutgoingAudioOptions()
outgoingAudioOptions.muted = true

let incomingAudioOptions = IncomingAudioOptions()
incomingAudioOptions.muted = true

var copyAcceptCallOptions = AcceptCallOptions()
copyStartCallOptions.outgoingAudioOptions = outgoingAudioOptions
copyStartCallOptions.incomingAudioOptions = incomingAudioOptions

callAgent.startCall(participants: participants,
                    options: copyStartCallOptions,
                    completionHandler: completionBlock)

Отключение динамика и микрофона гарантирует, что физические звуковые устройства не будут использованы до тех пор, пока CallKit не вызовет функцию didActivateAudioSession на CXProviderDelegate. В противном случае звонок может быть удален или звук не будет работать. Когда didActivateAudioSession следует запустить аудиопотоки.

func provider(_ provider: CXProvider, didActivate audioSession: AVAudioSession) {
    Task {
        guard let activeCall = await self.callKitHelper.getActiveCall() else {
            print("No active calls found when activating audio session !!")
            return
        }

        try await startAudio(call: activeCall)
    }
}

func provider(_ provider: CXProvider, didDeactivate audioSession: AVAudioSession) {
    Task {
        guard let activeCall = await self.callKitHelper.getActiveCall() else {
            print("No active calls found when deactivating audio session !!")
            return
        }

        try await stopAudio(call: activeCall)
    }
}

private func stopAudio(call: Call) async throws {
    try await self.callKitHelper.muteCall(callId: call.id, isMuted: true)
    try await call.stopAudio(stream: call.activeOutgoingAudioStream)

    try await call.stopAudio(stream: call.activeIncomingAudioStream)
    try await call.muteIncomingAudio()
}

private func startAudio(call: Call) async throws {
    try await call.startAudio(stream: LocalOutgoingAudioStream())
    try await self.callKitHelper.muteCall(callId: call.id, isMuted: false)

    try await call.startAudio(stream: RemoteIncomingAudioStream())
    try await call.unmuteIncomingAudio()
}
    

Важно также отключить исходящий звук перед остановкой звука в случаях, когда CallKit не вызывается didActivateAudioSession. Затем пользователь может вручную включить микрофон.

Дальнейшие шаги

• Узнайте, как управлять видео
• Узнайте, как управлять вызовами
• Узнайте, как записывать вызовы