--- title: 耳机解决方案 - API summary: 耳机解决方案的 API 接口列表，包括音频操作（startAudioRecording/pauseRecordTransfer/resumeRecordTransfer/stopRecordTransfer 等）、音频文件操作、离线传输与云同步、转写和总结、翻译、设备与快捷入口，以及音频相关事件监听。 --- # API ## 音频操作 ### 开始录音 - **含义**：开始录音转写 - **接口详情**：[startAudioRecording](/cn/miniapp/develop/ray/api/ai/wear/recordOpt/startAudioRecording) ### 暂停录音 - **含义**：暂停录音 - **接口详情**：[pauseRecordTransfer](/cn/miniapp/develop/ray/api/ai/wear/recordOpt/pauseRecordTransfer) ### 恢复录音 - **含义**：恢复录音 - **接口详情**：[resumeRecordTransfer](/cn/miniapp/develop/ray/api/ai/wear/recordOpt/resumeRecordTransfer) ### 停止录音 - **含义**：停止录音 - **接口详情**：[stopRecordTransfer](/cn/miniapp/develop/ray/api/ai/wear/recordOpt/stopRecordTransfer) ### 更新录音参数 - **含义**：更新录音参数 - **接口详情**：[updateParams](/cn/miniapp/develop/ray/api/ai/wear/recordOpt/updateParams) ### 切换录音通道 - **含义**：切换录音通道 - **接口详情**：[switchRecordChannel](/cn/miniapp/develop/ray/api/ai/wear/recordOpt/switchRecordChannel) ### 控制原生录音状态悬浮框 - **含义**：控制原生录音状态悬浮框 - **接口详情**：[operateRecordingFloat](/cn/miniapp/develop/ray/api/ai/wear/recordOpt/operateRecordingFloat) ### 事件流控制 - **含义**：事件流控制 - **接口详情**：[operateEventLimit](/cn/miniapp/develop/ray/api/ai/wear/recordOpt/operateEventLimit) ## 音频文件相关操作 ### 获取录音转写列表 - **含义**：获取录音转写列表 - **接口详情**：[getRecordTransferResultList](/cn/miniapp/develop/ray/api/ai/wear/recordFileOpt/getRecordTransferResultList) ### 搜索录音转写 - **含义**：搜索录音转写 - **接口详情**：[searchRecordTransferResult](/cn/miniapp/develop/ray/api/ai/wear/recordFileOpt/searchRecordTransferResult) ### 更新录音文件信息 - **含义**：更新录音文件信息，比如文件名称等 - **接口详情**：[updateRecordTransferResult](/cn/miniapp/develop/ray/api/ai/wear/recordFileOpt/updateRecordTransferResult) ### 批量删除录音文件 - **含义**：批量或者单个删除录音文件 - **接口详情**：[removeFileList](/cn/miniapp/develop/ray/api/ai/wear/recordFileOpt/removeFileList) ### 获取音频文件总占用空间 - **含义**：获取音频文件总占用空间 - **接口详情**：[getAudioFilesSize](/cn/miniapp/develop/ray/api/ai/wear/recordFileOpt/getAudioFilesSize) ### 获取音频分享合规路径 - **含义**：获取音频分享合规路径 - **接口详情**：[operateAudioFileSafePath](/cn/miniapp/develop/ray/api/ai/wear/recordFileOpt/operateAudioFileSafePath) ### 操作录音文件分享链接 - **含义**：操作录音文件分享链接 - **接口详情**：[operateRecordShareLink](/cn/miniapp/develop/ray/api/ai/wear/recordFileOpt/operateRecordShareLink) ### 批量合并录音 - **含义**：批量合并录音 - **接口详情**：[mergeRecordList](/cn/miniapp/develop/ray/api/ai/wear/recordFileOpt/mergeRecordList) ### 取消合并录音 - **含义**：取消合并录音 - **接口详情**：[cancelMergeRecordList](/cn/miniapp/develop/ray/api/ai/wear/recordFileOpt/cancelMergeRecordList) ### 查询录音合并状态 - **含义**：查询录音合并状态 - **接口详情**：[getFileMergeStatus](/cn/miniapp/develop/ray/api/ai/wear/recordFileOpt/getFileMergeStatus) ### 更新标签 - **含义**：更新标签 - **接口详情**：[updateRecordTagResult](/cn/miniapp/develop/ray/api/ai/wear/recordFileOpt/updateRecordTagResult) ## 离线传输与云同步 ### 下载离线文件 - **含义**：下载离线文件 - **接口详情**：[loadOfflineFile](/cn/miniapp/develop/ray/api/ai/wear/offlineSync/loadOfflineFile) ### 查询设备离线文件下载状态 - **含义**：查询设备离线文件下载状态 - **接口详情**：[getDeviceOfflineFileStatus](/cn/miniapp/develop/ray/api/ai/wear/offlineSync/getDeviceOfflineFileStatus) ### 切换 AP/BLE 模式传输 - **含义**：切换 AP/BLE 模式传输 - **接口详情**：[switchModeLoadOfflineFile](/cn/miniapp/develop/ray/api/ai/wear/offlineSync/switchModeLoadOfflineFile) ### 获取云同步开关状态 - **含义**：获取云同步开关状态 - **接口详情**：[getCloudSyncSwitchStatus](/cn/miniapp/develop/ray/api/ai/wear/offlineSync/getCloudSyncSwitchStatus) ### 同步 Note 记录 - **含义**：同步 Note 记录 - **接口详情**：[syncNoteRecord](/cn/miniapp/develop/ray/api/ai/wear/offlineSync/syncNoteRecord) ### 同步下载 Note 音频 - **含义**：同步下载 Note 音频 - **接口详情**：[syncDownloadNoteAudio](/cn/miniapp/develop/ray/api/ai/wear/offlineSync/syncDownloadNoteAudio) ### 触发导入文件 - **含义**：触发导入文件 - **接口详情**：[startImport](/cn/miniapp/develop/ray/api/ai/wear/offlineSync/startImport) ### 重试导入 - **含义**：重试导入 - **接口详情**：[retryImport](/cn/miniapp/develop/ray/api/ai/wear/offlineSync/retryImport) ### 取消导入 - **含义**：取消导入 - **接口详情**：[cancelImport](/cn/miniapp/develop/ray/api/ai/wear/offlineSync/cancelImport) ### 取消重试 - **含义**：取消重试 - **接口详情**：[cancelRetry](/cn/miniapp/develop/ray/api/ai/wear/offlineSync/cancelRetry) ### 获取音频导入状态 - **含义**：获取音频导入状态 - **接口详情**：[getAudioImportStatus](/cn/miniapp/develop/ray/api/ai/wear/offlineSync/getAudioImportStatus) ## 转写和总结 ### 获取实时转写数据 - **含义**：获取实时转写数据 - **接口详情**：[getRecordTransferRealTimeResult](/cn/miniapp/develop/ray/api/ai/wear/aboutTransfer/getRecordTransferRealTimeResult) ### 保存转写结果 - **含义**：保存转写结果 - **接口详情**：[saveRecordTransferRecognizeResult](/cn/miniapp/develop/ray/api/ai/wear/aboutTransfer/saveRecordTransferRecognizeResult) ### 保存总结结果 - **含义**：保存总结结果 - **接口详情**：[saveRecordTransferSummaryResult](/cn/miniapp/develop/ray/api/ai/wear/aboutTransfer/saveRecordTransferSummaryResult) ### 更新实时转写结果 - **含义**：更新实时转写结果 - **接口详情**：[saveRecordTransferRealTimeRecognizeResult](/cn/miniapp/develop/ray/api/ai/wear/aboutTransfer/saveRecordTransferRealTimeRecognizeResult) ### 查询转写状态 - **含义**：查询转写状态 - **接口详情**：[getRecordTransferProcessStatus](/cn/miniapp/develop/ray/api/ai/wear/aboutTransfer/getRecordTransferProcessStatus) ### 查询转写结果 - **含义**：查询转写结果 - **接口详情**：[getRecordTransferRecognizeResult](/cn/miniapp/develop/ray/api/ai/wear/aboutTransfer/getRecordTransferRecognizeResult) ### 对录音记录进行转写总结 - **含义**：对录音记录进行转写总结 - **接口详情**：[processRecordTransferResult](/cn/miniapp/develop/ray/api/ai/wear/aboutTransfer/processRecordTransferResult) ### 查询录音转写详情 - **含义**：查询录音转写详情 - **接口详情**：[getRecordTransferResultDetail](/cn/miniapp/develop/ray/api/ai/wear/aboutTransfer/getRecordTransferResultDetail) ### 查询录音转写总结 - **含义**：查询录音转写总结 - **接口详情**：[getRecordTransferSummaryResult](/cn/miniapp/develop/ray/api/ai/wear/aboutTransfer/getRecordTransferSummaryResult) ### 查询录音任务状态 - **含义**：查询录音任务状态 - **接口详情**：[recordTransferTask](/cn/miniapp/develop/ray/api/ai/wear/aboutTransfer/recordTransferTask) ## 翻译 ### 发起翻译 - **含义**：发起翻译 - **接口详情**：[startTranslate](/cn/miniapp/develop/ray/api/ai/wear/translate/startTranslate) ### 获取翻译记录列表 - **含义**：获取翻译记录列表 - **接口详情**：[getTranslateFileList](/cn/miniapp/develop/ray/api/ai/wear/translate/getTranslateFileList) ### 获取翻译记录详情 - **含义**：获取翻译记录详情 - **接口详情**：[getTranslateFileDetail](/cn/miniapp/develop/ray/api/ai/wear/translate/getTranslateFileDetail) ### 将翻译发送到总结 - **含义**：将翻译发送到总结 - **接口详情**：[sendToNote](/cn/miniapp/develop/ray/api/ai/wear/translate/sendToNote) ### 批量删除翻译文件 - **含义**：批量删除翻译文件 - **接口详情**：[batchRemoveTranslationFiles](/cn/miniapp/develop/ray/api/ai/wear/translate/batchRemoveTranslationFiles) ## 设备与快捷入口 ### 获取耳机蓝牙连接状态 - **含义**：获取耳机蓝牙连接状态 - **接口详情**：[getEarPhoneBTConntectedStatus](/cn/miniapp/develop/ray/api/ai/wear/device/getEarPhoneBTConntectedStatus) ### 建立小程序与客户端通道 - **含义**：建立小程序与客户端通道 - **接口详情**：[readyToSetupNativeChannel](/cn/miniapp/develop/ray/api/ai/wear/device/readyToSetupNativeChannel) ### 获取快速启动入口列表 - **含义**：获取快速启动入口列表 - **接口详情**：[getQuickEntryList](/cn/miniapp/develop/ray/api/ai/wear/device/getQuickEntryList) ### 开启或关闭快速启动入口 - **含义**：开启或关闭快速启动入口 - **接口详情**：[setQuickEntryEnabled](/cn/miniapp/develop/ray/api/ai/wear/device/setQuickEntryEnabled) ## 音频相关事件监听 ### 实时翻译录音事件通知 - **含义**：实时翻译录音事件通知 - **接口详情**：[onRecordTransferRealTimeRecognizeStatusUpdateEvent](/cn/miniapp/develop/ray/api/ai/wear/recordEventListener/onRecordTransferRealTimeRecognizeStatusUpdateEvent) ### 移除实时翻译录音事件通知监听 - **含义**：移除实时翻译录音事件通知监听 - **接口详情**：[offRecordTransferRealTimeRecognizeStatusUpdateEvent](/cn/miniapp/develop/ray/api/ai/wear/recordEventListener/offRecordTransferRealTimeRecognizeStatusUpdateEvent) ### 录音转写振幅更新事件监听 - **含义**：录音转写振幅更新事件监听 - **接口详情**：[onRecordTransferAmplitudeUpdateEvent](/cn/miniapp/develop/ray/api/ai/wear/recordEventListener/onRecordTransferAmplitudeUpdateEvent) ### 移除录音转写振幅更新事件监听 - **含义**：移除录音转写振幅更新事件监听 - **接口详情**：[offRecordTransferAmplitudeUpdateEvent](/cn/miniapp/develop/ray/api/ai/wear/recordEventListener/offRecordTransferAmplitudeUpdateEvent) ### 录音状态变更事件监听 - **含义**：录音状态变更事件监听 - **接口详情**：[onRecordTransferStatusUpdateEvent](/cn/miniapp/develop/ray/api/ai/wear/recordEventListener/onRecordTransferStatusUpdateEvent) ### 移除录音状态变更事件监听 - **含义**：移除录音状态变更事件监听 - **接口详情**：[offRecordTransferStatusUpdateEvent](/cn/miniapp/develop/ray/api/ai/wear/recordEventListener/offRecordTransferStatusUpdateEvent) ### 录音结束的通知事件监听 - **含义**：录音结束的通知事件监听 - **接口详情**：[onRecordTransferFinishEvent](/cn/miniapp/develop/ray/api/ai/wear/recordEventListener/onRecordTransferFinishEvent) ### 移除录音结束的通知事件监听 - **含义**：移除录音结束的通知事件监听 - **接口详情**：[offRecordTransferFinishEvent](/cn/miniapp/develop/ray/api/ai/wear/recordEventListener/offRecordTransferFinishEvent) ### 录音转写文件上传进度事件监听 - **含义**：录音转写文件上传进度事件监听 - **接口详情**：[onRecordTransferFileUploadEvent](/cn/miniapp/develop/ray/api/ai/wear/recordEventListener/onRecordTransferFileUploadEvent) ### 移除录音转写文件上传进度事件监听 - **含义**：移除录音转写文件上传进度事件监听 - **接口详情**：[offRecordTransferFileUploadEvent](/cn/miniapp/develop/ray/api/ai/wear/recordEventListener/offRecordTransferFileUploadEvent) ### 输入源切换变更事件监听 - **含义**：输入源切换变更事件监听 - **接口详情**：[onRecordSwitchAudioSourceEvent](/cn/miniapp/develop/ray/api/ai/wear/recordEventListener/onRecordSwitchAudioSourceEvent) ### 移除输入源切换变更事件监听 - **含义**：移除输入源切换变更事件监听 - **接口详情**：[offRecordSwitchAudioSourceEvent](/cn/miniapp/develop/ray/api/ai/wear/recordEventListener/offRecordSwitchAudioSourceEvent) ### 录音场景电量变化事件监听 - **含义**：录音场景电量变化事件监听 - **接口详情**：[onRecordBatteryChangeEvent](/cn/miniapp/develop/ray/api/ai/wear/recordEventListener/onRecordBatteryChangeEvent) ### 移除录音场景电量变化事件监听 - **含义**：移除录音场景电量变化事件监听 - **接口详情**：[offRecordBatteryChangeEvent](/cn/miniapp/develop/ray/api/ai/wear/recordEventListener/offRecordBatteryChangeEvent) ### 录音质量变化事件监听 - **含义**：录音质量变化事件监听 - **接口详情**：[onRecordQualityChangeEvent](/cn/miniapp/develop/ray/api/ai/wear/recordEventListener/onRecordQualityChangeEvent) ### 移除录音质量变化事件监听 - **含义**：移除录音质量变化事件监听 - **接口详情**：[offRecordQualityChangeEvent](/cn/miniapp/develop/ray/api/ai/wear/recordEventListener/offRecordQualityChangeEvent) ### 耳机蓝牙连接状态变更事件监听 - **含义**：耳机蓝牙连接状态变更事件监听 - **接口详情**：[onEarPhoneBTConnectedStatusChangeEvent](/cn/miniapp/develop/ray/api/ai/wear/recordEventListener/onEarPhoneBTConnectedStatusChangeEvent) ### 移除耳机蓝牙连接状态变更事件监听 - **含义**：移除耳机蓝牙连接状态变更事件监听 - **接口详情**：[offEarPhoneBTConnectedStatusChangeEvent](/cn/miniapp/develop/ray/api/ai/wear/recordEventListener/offEarPhoneBTConnectedStatusChangeEvent) ### 离线文件传输进度事件监听 - **含义**：离线文件传输进度事件监听 - **接口详情**：[onOfflineFilesProgressEvent](/cn/miniapp/develop/ray/api/ai/wear/recordEventListener/onOfflineFilesProgressEvent) ### 移除离线文件传输进度事件监听 - **含义**：移除离线文件传输进度事件监听 - **接口详情**：[offOfflineFilesProgressEvent](/cn/miniapp/develop/ray/api/ai/wear/recordEventListener/offOfflineFilesProgressEvent) ### 文件导入状态事件监听 - **含义**：文件导入状态事件监听 - **接口详情**：[onFileImportStatusEvent](/cn/miniapp/develop/ray/api/ai/wear/recordEventListener/onFileImportStatusEvent) ### 移除文件导入状态事件监听 - **含义**：移除文件导入状态事件监听 - **接口详情**：[offFileImportStatusEvent](/cn/miniapp/develop/ray/api/ai/wear/recordEventListener/offFileImportStatusEvent) ### 云同步开关状态事件监听 - **含义**：云同步开关状态事件监听 - **接口详情**：[onCloudSyncSwitchStatusEvent](/cn/miniapp/develop/ray/api/ai/wear/recordEventListener/onCloudSyncSwitchStatusEvent) ### 移除云同步开关状态事件监听 - **含义**：移除云同步开关状态事件监听 - **接口详情**：[offCloudSyncSwitchStatusEvent](/cn/miniapp/develop/ray/api/ai/wear/recordEventListener/offCloudSyncSwitchStatusEvent) ### 记录同步状态事件监听 - **含义**：记录同步状态事件监听 - **接口详情**：[onPartialRecordUpdate](/cn/miniapp/develop/ray/api/ai/wear/recordEventListener/onPartialRecordUpdate) ### 移除记录同步状态事件监听 - **含义**：移除记录同步状态事件监听 - **接口详情**：[offPartialRecordUpdate](/cn/miniapp/develop/ray/api/ai/wear/recordEventListener/offPartialRecordUpdate) ### 文件列表状态刷新事件监听 - **含义**：文件列表状态刷新事件监听 - **接口详情**：[onFileListUpdateStatusEvent](/cn/miniapp/develop/ray/api/ai/wear/recordEventListener/onFileListUpdateStatusEvent) ### 移除文件列表状态刷新事件监听 - **含义**：移除文件列表状态刷新事件监听 - **接口详情**：[offFileListUpdateStatusEvent](/cn/miniapp/develop/ray/api/ai/wear/recordEventListener/offFileListUpdateStatusEvent) ### 文件合并状态事件监听 - **含义**：文件合并状态事件监听 - **接口详情**：[onFileMergeStatusEvent](/cn/miniapp/develop/ray/api/ai/wear/recordEventListener/onFileMergeStatusEvent) ### 移除文件合并状态事件监听 - **含义**：移除文件合并状态事件监听 - **接口详情**：[offFileMergeStatusEvent](/cn/miniapp/develop/ray/api/ai/wear/recordEventListener/offFileMergeStatusEvent) ### 小程序 Push 刷新事件监听 - **含义**：小程序 Push 刷新事件监听 - **接口详情**：[onPushRouteInfoEvent](/cn/miniapp/develop/ray/api/ai/wear/recordEventListener/onPushRouteInfoEvent) ### 移除小程序 Push 刷新事件监听 - **含义**：移除小程序 Push 刷新事件监听 - **接口详情**：[offPushRouteInfoEvent](/cn/miniapp/develop/ray/api/ai/wear/recordEventListener/offPushRouteInfoEvent) ### 快速启动入口添加结果事件监听 - **含义**：快速启动入口添加结果事件监听 - **接口详情**：[onQuickEntryAddEvent](/cn/miniapp/develop/ray/api/ai/wear/recordEventListener/onQuickEntryAddEvent) ### 移除快速启动入口添加结果事件监听 - **含义**：移除快速启动入口添加结果事件监听 - **接口详情**：[offQuickEntryAddEvent](/cn/miniapp/develop/ray/api/ai/wear/recordEventListener/offQuickEntryAddEvent) ### 文本翻译 TTS 完成事件监听 - **含义**：文本翻译 TTS 完成事件监听 - **接口详情**：[onTextTranslateTtsCompleteEvent](/cn/miniapp/develop/ray/api/ai/wear/recordEventListener/onTextTranslateTtsCompleteEvent) ### 移除文本翻译 TTS 完成事件监听 - **含义**：移除文本翻译 TTS 完成事件监听 - **接口详情**：[offTextTranslateTtsCompleteEvent](/cn/miniapp/develop/ray/api/ai/wear/recordEventListener/offTextTranslateTtsCompleteEvent)