本页按 Topic、method 和方向定义完整契约。字段表与JSON中的可选扩展不等于当前全部启用，实际接入前请查支持范围；应用REST封装见应用接入。

当前设备方法60个（按Topic/方向64条），应用接口/事件19个；总计79个不同名字、83条索引。新增的是可选UDP安装回执的反向条目，不是新增method、Topic或版本。公共流程见复用说明。

查阅规则

AI交互的完整方法和音频传输规范同属本栏目：

• AI交互命令：$thing/*/ai的会话、输入、回复、取消和关闭。
• UDP音频通道：16字节包头、AES-CTR、Opus及传输规则；统一信令的128步长与回复屏障同时参见AI音频控制。
• AI功能配置与设备接入：能力配置、设备绑定和拍照识图。

先读公共约定，再按下面的分类索引定位命令。应用字段复用设备契约时，以命令页指定引用为准，不维护第二套字段。物模型及内部RPC单独见复用边界，不计入设备信令方法。

能力与会话

Topic/接口	method	类型	对应应答/事件
SIG↑	capabilityReport	请求	requestAck
SIG↑	sessionCreate	请求	sessionCreated
SIG↓	sessionCreated	应答	—
SIG↓	sessionInvite	请求	sessionAccept 或 sessionReject
SIG↑	sessionAccept	请求	requestAck
SIG↑	sessionReject	请求	requestAck
SIG↓	sessionEstablished	事件	—
SIG↑	sessionEnd	请求	sessionEnded
SIG↓	sessionEnded	应答或事件	—
SIG↓	sessionError	事件	—

媒体与处理器

Topic/接口	method	类型	对应应答/事件
SIG↑	mediaOffer	请求	mediaAnswer
SIG↓	mediaAnswer	应答	—
SIG↑	mediaState	请求	requestAck
SIG↑	trackControl	请求	反方向 trackState
SIG↑	trackState	应答或事件	—
SIG↓	trackControl	请求	反方向 trackState
SIG↓	trackState	应答或事件	—
SIG↓	participantChanged	事件	—
SIG↓	processorState	事件	—

AI音频控制

Topic/接口	method	类型	对应应答/事件
SIG↑	audioStart	请求	requestAck
SIG↑	audioStop	请求	requestAck
SIG↑	respCancel	请求	requestAck
SIG↓	respAudioStart	事件	已选UDP安装确认时为反向同method回执
SIG↑	respAudioStart	可选安装事实回执	—；不再ACK
SIG↓	respAudioDone	事件	—
SIG↓	audioSpeechInterrupted	事件	—

内容与异步消息

Topic/接口	method	类型	对应应答/事件
MSG↓	respCreated	事件	—
MSG↓	respSttDelta	事件	—
MSG↓	respSttDone	事件	—
MSG↓	respTextDelta	事件	—
MSG↓	respTextDone	事件	—
MSG↓	toolCallStart	事件	—
MSG↓	toolCallExecute	客户端执行事件	toolCallSubmit业务结果
MSG↓	toolCallResult	事件	—
MSG↓	translationResult	事件	—
MSG↓	messageDeliver	请求	messageAck
MSG↑	messageAck	应答或事件	—
MSG↓	contextSnapshot	会话内私有事件	contextSnapshotAck
MSG↑	contextSnapshotAck	完整留存回执	—

多模态与客户端工具

Topic/接口	method	类型	对应应答/事件
MSG↑	inputSend	请求	requestAck
MSG↓	respMedia	事件	—
MSG↓	respEmotion	事件	—
MSG↓	respDone	事件	—
MSG↑	toolCallSubmit	请求	requestAck

通用请求应答

Topic/接口	method	类型	对应应答/事件
SIG↓	requestAck	应答	—
MSG↓	requestAck	应答	—

会议与媒体扩展控制

Topic/接口	method	类型	对应应答/事件
SIG↑	callControl	请求	callState
SIG↓	callState	应答/事件	—
SIG↑	floorControl	请求	floorState
SIG↓	floorState	应答/事件	—
SIG↑	mediaUpdate	请求	mediaUpdated
SIG↓	mediaUpdated	应答/事件	—
SIG↑	recordingControl	请求	recordingState
SIG↓	recordingState	应答/事件	—
SIG↓	playbackControl	请求	playbackState
SIG↑	playbackState	应答/事件	—
SIG↑	broadcastControl	请求	broadcastState
SIG↓	broadcastState	应答/事件	—
SIG↑	endpointControl	请求	endpointState
SIG↓	endpointState	应答/事件	—
SIG↓	focusControl	请求	focusState
SIG↑	focusState	应答/事件	—
SIG↑	sessionSync	请求	sessionSnapshot
SIG↓	sessionSnapshot	应答/事件	—

应用接口与事件

Topic/接口	method	类型	对应应答/事件
APP↑	interaction.open	请求	HTTP受理；随后 interaction.result
APP↑	interaction.end	请求	HTTP受理；随后 interaction.result
APP↑	interaction.join	请求	HTTP受理；随后 interaction.result
APP↑	interaction.leave	请求	HTTP受理；随后 interaction.result
APP↑	interaction.subscribe	请求	HTTP受理；随后 interaction.result
APP↑	interaction.mediaOffer	请求	HTTP受理；随后 interaction.result
APP↑	interaction.mediaState	请求	HTTP受理；随后 interaction.result
APP↑	interaction.trackControl	请求	HTTP受理；随后 interaction.result
APP↑	interaction.configure	请求	HTTP受理；随后 interaction.result
APP↑	interaction.processorControl	请求	HTTP受理；随后 interaction.result
APP↑	messageSend	请求	HTTP受理；随后 interaction.result
APP↑	device.action	请求	HTTP受理；随后 interaction.result
APP↑	device.propertyControl	请求	HTTP受理；随后 interaction.result
APP↓	interaction.result	应答	—
APP↓	interaction.state	事件	—
APP↑	interaction.control	请求	interaction.result
APP↓	interaction.controlState	应答/事件	—
APP↓	interaction.invite	邀请事件	interaction.control(sessionAccept/sessionReject)
APP↓	interaction.message	事件	—

路由全称见公共约定；新AI的所有控制和内容均在本索引，不隐含其他Topic依赖。错误应答使用该请求规定的应答method与原token，纯受理应答统一requestAck，sessionError是独立异步错误事件。

requestAck两个路由条目是同一个方法名；成功result依原请求定义，不能取代独立完成事件。流程用法见场景手册，完整性检查见支持范围。

更新日志

2026/10/16 17:05

查看所有更新日志

• 73db2-docs(AI与音视频): 统一AI命令和UDP栏目并保留原网址于 2026/10/16
• fe3a7-docs(AI与音视频): 按场景整理完整接入流程与命令契约于 2026/10/16

贡献者: godLei6

上一页图片与文件附件接入

下一页能力与会话命令