跳到主要内容

工作状态概述

本节介绍 AIBuds SDK 用于监控设备当前工作状态的 API，提供设备正在执行何种活动的实时信息。

功能概览​

使用 AI 辅助实现

使用 AI 开发

让 AI 帮助实现此工作流

使用官方“管理 AIBuds 工作状态与模式”技能，根据你的 App 完成实现。

请阅读并遵循 https://docs-aibuds.github.io/zh-Hans/skills/manage-aibuds-work-state-and-mode，使用该技能在当前 iOS 项目中完成“管理 AIBuds 工作状态与模式”，并验证结果。
查看官方技能

开始使用​

监控工作状态时，请按以下步骤操作：

  1. 连接设备：与 AIBuds 设备建立连接。
  2. 检查协议支持：确认设备支持 DeviceWorkStateAPI。
  3. 获取状态：读取当前 workState 属性。
  4. 监听变化：在设备代理中实现 device(_:didWorkStateChanged:)。

关键概念​

工作状态​

完整的 WorkState 枚举说明请参阅工作状态。这些值可分为：

  • 连接与空闲：等待连接、已连接空闲或已断开空闲。
  • 播放与通信：本地音乐播放、电话通话或 AI 对话。
  • 采集与传输：拍照、视频/音频录制、文件传输或直播。
  • 维护：恢复出厂设置、OTA 升级、关机或设备测试状态。

协议参考​

工作状态功能通过 DeviceWorkStateAPI 协议访问：

Swift
guard let device = device as? DeviceWorkStateAPI else {
    print("Device does not support DeviceWorkStateAPI")
    return
}

最佳实践​

  1. 检查协议支持：始终确认设备支持 DeviceWorkStateAPI。
  2. 监控状态：状态变化时，通过设备代理回调更新 UI。
  3. 处理状态转换：设备状态变化时作出适当响应。
  4. 避免冲突：不要发起与当前状态冲突的操作。

注意事项​

  • 工作状态提供设备活动的实时信息。
  • 工作状态变化可通过可选的设备代理回调报告。
  • 某些状态可能阻止特定操作执行。