打造实时沟通体验

借助 LiveCommunicationKit，让你的实时通信 App 大变身，为用户带来深度整合的沟通体验。我们将介绍如何提供丰富的原生对话 UI，让你的 App 出现在恰如用户所需的地方，比如全屏显示在锁定屏幕上，以及通过灵动岛实现丝滑的多任务处理。与我们一起逐步了解如何整合这一消息收发和群组对话框架。

章节

资源

相关视频

WWDC25

了解 App Intents

WWDC22

利用 Push to Talk 优化语音通信

你好我是Yaseen Apple软件工程师本节课我将向你展示如何提供丰富的原生会话界面让你的App出现在用户需要的地方从锁定屏幕上的全屏展示到与Dynamic Island的无缝多任务处理这从会话接入的那一刻就开始了当你的App采用此API时其会话会在锁定屏幕上以全屏方式呈现包含联系人姓名、照片以及一套标准操作控件这与来电时的界面完全一致

采用此API的App 可获得相同的呈现效果会话也可以出现在电话App的最近通话中以及联系人详情里最近通话显示通话对象和时间用户可点击发起新的会话 LiveCommunicationKit是构建通信App的现代方式可与这些系统体验无缝集成如果你的App使用了传统实现方式例如CXProvider API 现在正是迁移到 LiveCommunicationKit的好时机它提供了更灵活功能更丰富的API 以集成各种类型的实时会话让你的App全面支持我将从核心概念讲起什么是会话会话的生命周期如何运作以及你的App如何与系统进行通信接下来介绍接收会话的流程从推送通知唤醒App 到在锁定屏幕上呈现会话然后介绍从App内发起呼出会话以及通过Siri 和最近通话访问会话最后是群组会话包括管理参与者以及合并会话为了了解这一切的工作原理我将以一群大学好友为例 David Ryan Andre 以及Adam 他们使用我的语音会话App 规划年度聚会旅行不过首先简要介绍一下 LiveCommunicationKit的工作原理我刚才介绍的所有体验都由一个对象驱动那就是会话会话代表人与人之间的一次实时互动它的存在时间取决于是否有人在其中所有人离开后会话即结束会话包含两个部分句柄代表会话中的参与者以及能力描述会话可以执行的操作我先从句柄讲起句柄用于标识一个人它有三个属性 kind、value和display name 我将逐一介绍 kind告诉系统句柄的标识符类型可以是电话号码、电子邮件地址或通用字符串如果你的App已通过电话号码或邮件识别用户设置正确的kind 可让系统匹配将用户句柄与已存联系人关联并在系统会话界面中显示其姓名和照片 value是标识符本身即电话号码、电子邮件或通用字符串系统使用此值查找联系人也是用户从最近通话回拨时 App收到的值 display name是系统在无法匹配联系人时所显示的名称将其设置为App 已知的用户姓名以便会话界面始终有内容可显示能力告知系统会话可以执行的操作系统据此决定显示哪些控件以及启用哪些手势使会话界面只提供 App实际支持的功能

系统显示一套标准的会话内控件静音、扬声器、键盘和更多其中部分控件需要App主动启用此处声明了暂停能力长按静音按钮即可将会话置为保持状态若未声明此能力长按将不起任何作用视频能力告知系统这是一个视频会话视频按钮由App的 provider配置启用稍后我会介绍能力可以在会话过程中随时更改当会话从音频升级到视频时 App更新相应能力系统会立即反映这一变化现在你已了解会话的构成要素我将介绍会话如何与系统配合完成生命周期当你的App首次向系统报告会话时会话从空闲状态开始设备随即开始响铃响铃期间 App可开始本地初始化当用户接听时 App将状态设置为joining 系统将界面更新为显示会话正在连接同时App完成设置准备加入会话此时尚未开始音频或视频捕获当App完成准备后将状态设置为joined 并开始捕获和发送音频与视频会话随即正式开始若用户切换到AirPods 或连接车载蓝牙 App将收到路由更改通知并相应更新捕获管线若你的App声明了暂停能力系统将启用其保持控件当用户将会话置为保持时系统会请求App暂停 App暂停媒体流并报告新状态当用户恢复会话时系统要求App恢复会话的媒体流并报告此变化会话结束时你的App将状态设置为leaving 这一阶段App会拆除会话并清理其连接拆除完成后 App将状态设置为left 会话至此结束那么你的App如何实际驱动这一切我先从架构讲起你的App通过 ConversationManager驱动会话生命周期以及其委托你的App通过manager 报告会话和事件每次向系统告知新会话或已有会话的变化都需要通过manager进行这样你的会话才能出现在锁定屏幕上在Dynamic Island中以及其他所有地方委托是你的App 响应系统的地方每当会话需要执行某项操作时该操作会到达委托方法你的App执行相应工作来完成它

它们通过动作进行通信当用户与系统界面交互时例如从锁定屏幕接受会话或从Dynamic Island结束会话系统会创建一个动作并发送给你的委托当用户点击App 自身界面中的按钮时则由你的App创建该动作每一次交互无论来自系统界面还是App内部都流经同一个委托回调因此每个动作的逻辑只需在一处处理统一的代码路径意味着不存在重复的状态管理也不会有App与系统状态不同步的风险在App报告任何会话之前需要先创建ConversationManager 下面是我的App 创建它的方式 ConversationManager的配置告诉系统所需的一切以便为你的App 呈现和管理会话你可以在App生命周期的任何时候更新此配置此处我的App从Bundle中提供了一个铃声以及一个PNG图标系统会同时展示两者与我App的会话一同显示在整个系统界面中接下来是会话群组限制当会话合并在一起时即形成一个群组这些值限制了同时存在的群组数量以及每个群组可容纳的会话数量还有我App的会话是否显示在电话App的最近通话列表中对于不支持回拨的一次性房间传入'false'将其排除在外以及App是否支持视频这将在系统界面中启用视频按钮以及我的App 支持哪些句柄类型至此我的App 创建了ConversationManager 由于整个App生命周期都需要manager 我的App在启动时就立即创建它最后我的App设置 manager的委托为了在App退到后台或设备锁定时继续会话我的App注册了Audio和 Voice over IP后台模式在Xcode中App目标的能力设置里配置好ConversationManager后我将完整演示一次传入会话的处理流程 David想开始规划今年的聚会旅行于是他与Adam发起会话讨论潜在的目的地 Adam的设备已锁屏但当David的会话接入时它直接出现在锁定屏幕上下面是我的App 实现这一效果的方式

当David与Adam 发起会话时他设备上的App构建了一个包含两个字段的payload 一个代表David电话号码的句柄以及该会话的唯一标识符 David的App随后将payload 发送到我App的服务器服务器再将其转发到Adam的设备当Adam的设备收到推送时我的App唤醒并解码payload 然后使用解码出的句柄构建Conversation.Update 此更新还包含会话的能力在本例中包括视频、暂停和合并我的App随后使用该更新向ConversationManager 报告会话系统随即更新界面以匹配 PushKit负责在会话到来时唤醒你的App 前提是App尚未运行当你App的服务器发送Voice over IP推送时 PushKit会启动你的App 并立即将payload 传递给委托方法你的App必须在方法返回前报告会话否则系统会终止该App 有关Voice over IP推送处理的更多内容请查阅PushKit文档以下是我App中该PushKit委托方法这是所有传入会话经过的入口点我的App首先从payload中提取句柄和会话UUID 然后使用解码出的句柄构建Conversation.Update 以及会话的能力并进行报告

Adam看到传入的会话滑动接听系统将界面更新为显示会话正在连接然后通过委托向我的App 发送JoinConversationAction 每次有人接听、暂停或合并会话时系统都会以动作的形式传递给我的App 我的App在一处统一处理它们即perform action委托回调每次动作到来时 ConversationManager都会调用它在回调内部我的App使用 switch语句路由每种动作类型到对应的处理器我来追踪join动作

处理join动作时我的App首先验证 ConversationManager 是否正在跟踪与该动作唯一标识符匹配的会话如果未找到匹配的会话我的App会使该动作失败然后报告会话已开始连接这会将状态设置为joining 一旦我的App报告了连接事件系统会在Adam的设备上更新会话界面

现在我的App进行自身设置连接到服务器并配置媒体流这个工作是异步的所以我的App将其封装在Task中以保持委托响应畅通设置完成后我的App报告连接成功并完成该动作如果设置因任何原因失败我的App会相应标记该动作以便系统在其端清理该会话会话现在处于joined状态界面也相应更新权衡几个选项后他们决定今年前往冰岛 Adam点击了结束按钮一旦他点击会话立即进入leaving状态界面也随之更新系统随后向我的App发送一个EndConversationAction 经由委托我的App拆除媒体流并完成该动作而在Adam的设备上会话从系统界面中消失接下来我来谈谈如何发起呼出会话在David和Adam 决定前往冰岛后 Adam与Ryan发起会话讨论大家的住宿安排这次 Adam从我的App内部发起会话当有人从你的App内部发起会话时你应该将其报告给系统以便人们在使用其他App时仍可继续会话为此你的App创建一个 start动作来呼响接收方设备然后在ConversationManager 上调用perform 并在其委托中处理该动作方式与之前的 join动作相同动作处理完成后接收方要么接听要么你的App报告会话未被接听或失败

下面是我的App表示 Adam与Ryan会话的方式它构建了一个StartConversationAction 带有新生成的唯一标识符和Ryan的句柄然后将该动作发送给 ConversationManager manager首先更新系统界面然后将动作转发给委托从这里开始我的App的处理方式与之前的join动作完全一致会话连接成功后 Adam和Ryan浏览了几个选项最终选定了雷克雅未克附近的一间小屋住宿确定后他们又聊了几分钟然后道别挂断了电话会话结束后用户可以从Spotlight 或最近通话中重新拨打你的App通过支持 start call intent来处理这一点该intent将以 NSUserActivity的形式传递给你App的场景以继续处理当你App的会话保存到最近通话时 Apple Intelligence 已了解它们但为了呈现你App对会话的自有表示也要在每次会话结束时捐献你自己的intent 要了解有关在App中集成intent的更多内容请观看 "了解App Intents"专场到目前为止所有内容都是一对一的群组会话引入了多个参与者在确定目的地和住宿后 Adam与David和Ryan 发起群组会话规划行程群组会话跟踪两种类型的成员 members包含所有受邀加入会话的人而activeRemoteMembers 只包含正在活跃传输媒体的人系统两者都需要 members告诉系统会话有多少参与者 activeRemoteMembers告诉系统哪些人正在活跃发送媒体

报告群组会话时我的App为每位参与者创建一个句柄然后创建一个startAction 包含所有受邀成员并进行报告会话开始后 David和Ryan相继加入为了报告此变化我的App构建一个会话更新将Adam指定为localMember 声明新的activeRemoteMembership 并列出会话支持的能力包括合并和取消合并我稍后会回到这个话题我的App随后通过manager 报告会话更新系统更新会话以反映新的成员情况在Adam、David和Ryan 讨论行程时 Ryan意识到还需要确认Andre的行程是否合适于是Ryan单独与Andre 发起会话来告知他现在有两个会话在并行运行原来的群组包含Adam、David和Ryan 以及Ryan与Andre 的单独会话 Ryan同时在两个会话中但只在与Andre的会话中活跃 Andre和Ryan就行程日期达成一致后他们希望把所有人召集回来一起确认完整计划而不是让群组挂断再重新发起会话我的App可以将两者合并我的App声明了合并能力系统会启用其合并控件界面当Ryan点击它时我的App合并两个会话整个群组现在加上Andre 可以完成行程规划接下来我来讲解会话合并的代码取消合并遵循相同的委托模式所以一旦你看过了合并处理器取消合并的处理将不会陌生当两个会话合并时 ConversationManager会传递一个MergeConversationAction 给我App的委托 merge动作携带两个唯一标识符分别对应两个待合并的会话处理器使用这些标识符查找我App本地表示两个会话的对应数据如果其中一个不存在（可能已经结束）处理器会立即使该动作失败

一旦我的App获得两个会话它使用combineStreams 在服务器上合并媒体流然后报告更新后的成员情况并完成该动作如果发生任何抛出 catch块会使该动作失败一旦我的App合并了两个会话系统会更新会话界面以反映新的合并会话状态所有人进入同一会话后群组最终确定了行程安排在蓝湖泡温泉黄金圈游览一天以及几次冰川徒步行程确定后 Andre和Ryan想单独去一起订购机票这样他们可以坐在飞机上相邻的位置由于会话支持取消合并能力他们可以回到各自的会话中而Adam和David则处理最后几个细节这就是LiveCommunicationKit 从锁定屏幕上的单个传入会话到合并群组会话该框架为你的App提供系统级会话界面出现在用户期望的每个地方锁定屏幕上最近通话中以及Siri 以下是接下来的行动建议采用ConversationManager 并在锁定屏幕上报告你的第一个传入会话捐献intent让Siri 知道如何发起会话将所有临时令牌替换为稳定句柄以支持从最近通话回拨并确保及时更新会话成员情况感谢观看

6:41 - Set up a conversation manager

// Set up a conversation manager

import LiveCommunicationKit

let configuration = ConversationManager.Configuration(
  ringtoneName: "SampleRingtone.caf",
  iconTemplateImageData: UIImage(named: "SampleIcon")?.pngData(),
  maximumConversationGroups: 1,
  maximumConversationsPerConversationGroup: 2,
  includesConversationInRecents: true,
  supportsVideo: true,
  supportedHandleTypes: [.phoneNumber, .emailAddress]
)

let manager = ConversationManager(configuration: configuration)
manager.delegate = self

9:22 - Report the incoming conversation to the system

// Report the incoming conversation to the system

import LiveCommunicationKit
import PushKit

final class SamplePushHandler: NSObject, PKPushRegistryDelegate {
  func pushRegistry(
    _ registry: PKPushRegistry,
    didReceiveIncomingVoIPPushWith payload: PKPushPayload,
    metadata: PKVoIPPushMetadata) async {

    guard let (handle, uuid) = parseConversationPayload(from: payload) else { return }

    let capabilities = [.video, .pausing, .merging]
    let update = Conversation.Update(members: [handle], capabilities: capabilities)
    try? await manager.reportNewIncomingConversation(uuid: uuid, update: update)
  }
}

9:57 - Implement the delegate

// Implement the delegate

import LiveCommunicationKit

final class SampleDelegate: ConversationManagerDelegate {
  func conversationManager(
    _ manager: ConversationManager,
    perform action: ConversationAction
  ) {
    switch action {
    case let action as JoinConversationAction:
      handleJoinAction(action)
    default:
      action.fail()
    }
  }
}

10:13 - Fulfill the join action

// Handle a failed connection

extension SampleDelegate {
 func handleJoinAction(_ action: JoinConversationAction) {
    guard let conversation = manager.conversations.first(where: {$0.uuid == uuid })else {
      return action.fail()
    }

    manager.reportConversationEvent(.conversationStartedConnecting(.now), for: conversation)

    Task {
      do {
        try await setupMediaStream(with: action.conversationUUID)
        manager.reportConversationEvent(.conversationConnected(.now), for: conversation)
        action.fulfill(dateConnected: .now)
      } catch {
        action.fail()
      }
    }
  }
}

11:17 - Route end actions

// Route end actions

final class SampleDelegate: ConversationManagerDelegate {
  // …
  func conversationManager(
    _ manager: ConversationManager,
    perform action: ConversationAction
  ) {
    switch action {
    case let action as JoinConversationAction:
      handleJoinAction(action)
    case let action as EndConversationAction:
      handleEndAction(action)
    default:
      action.fail()
    }
  }
}

12:14 - Create a start action

let startAction = StartConversationAction(
  conversationUUID: UUID(),
  handles: [Handle(type: .phoneNumber, value: "+1-650-555-0199", displayName: "Ryan Notch")],
  isVideo: false
)

12:23 - Perform the action

try await manager.perform([startAction])

12:29 - Route start actions

// Route start actions

final class SampleDelegate: ConversationManagerDelegate {
  // …
  func conversationManager(
    _ manager: ConversationManager,
    perform action: ConversationAction
  ) {
    switch action {
    case let action as JoinConversationAction:
      handleJoinAction(action)
    case let action as EndConversationAction:
      handleEndAction(action)
    case let action as StartConversationAction:
      handleStartAction(action)
    default:
      action.fail()
    }
  }
}

13:51 - Start group conversations

// Start group conversations

let adam = Handle(type: .emailAddress,
                  value: "adam.halwani@icloud.com",
                  displayName: "Adam Halwani")
let david = Handle(type: .emailAddress,
                   value: "david@example.com",
                   displayName: "David Evans")
let ryan = Handle(type: .phoneNumber,
                  value: "+16505550199",
                  displayName: "Ryan Notch")

let startAction = StartConversationAction(
  conversationUUID: UUID(),
  handles: [david, ryan],
  isVideo: false
)
try await manager.perform([startAction])

14:01 - Report group membership updates

// Report group membership updates

let update = Conversation.Update(
  localMember: adam,
  members: [david, ryan],
  activeRemoteMembers: [david, ryan],
  capabilities: [.merging, .pausing, .unmerging]
)

manager.reportConversationEvent(
  .conversationUpdated(update),
  for: conversation
)

15:26 - Route merge actions

// Route merge actions

final class SampleDelegate: ConversationManagerDelegate {
  func conversationManager(
    _ manager: ConversationManager,
    perform action: ConversationAction
  ) {
    switch action {
    case let action as JoinConversationAction:
      handleJoinAction(action)
    case let action as EndConversationAction:
      handleEndAction(action)
    case let action as StartConversationAction:
        handleStartAction(action)
    case let action as MergeConversationAction:
      handleMergeAction(action)
    default:
      action.fail()
    }
  }
}

15:33 - Handle the merge action

// Handle the merge action

extension SampleDelegate {
  func handleMergeAction(_ action: MergeConversationAction) {
    let sourceUUID = action.conversationUUID
    let targetUUID = action.conversationUUIDToMergeWith
    guard manager.conversations.contains(where: { $0.uuid == sourceUUID }),
          manager.conversations.contains(where: { $0.uuid == targetUUID }) else {
      return action.fail()
    }

    Task {
      do {
        let update = try await combineStreams(from: sourceUUID, into: targetUUID)
        manager.reportConversationEvent(.conversationUpdated(update), for: target)
        action.fulfill()
      } catch {
        action.fail()
      }
    }
  }
}

0:01 - Introduction
LiveCommunicationKit is the modern way to build live conversation experiences that integrate with the system. Conversations in LiveCommunicationKit are built upon fundamental elements, such as handles, display names, and capabilities, that configure the interface, as well as a single ConversationManager object to manage the full lifecycle.
7:56 - Incoming conversations
Incoming conversations rely on the ConversationManager class where you configure properties like ringtones, group limits, and supported handles. Use PushKit to deliver an incoming conversation to a device, then report it to the ConversationManager.
11:29 - Outgoing conversations
Start outgoing conversations initiated within the app by performing a StartConversationAction. This allows your app's ConversationManager delegate to handle the entire process, using the same unified action-handling logic for actions started by in-app or system UI.
13:18 - Groups
Track the full list of invited members in addition to the currently active remote members so the interface stays perfectly in sync as people join or drop off. Advanced call management is handled through delegate actions and supports merging and unmerging calls as needed.

探索“入门汇总”

及时了解最新动态

探索“平台”

精选

探索“技术”

精选

探索“社区”

精选

探索“文档”

发布说明

探索“下载”

精选

探索“支持”

精选

快速链接

打造实时沟通体验

章节

资源

相关视频

WWDC25

WWDC22