# 自定义_v1.0

# Custom Context

如果你有需要从设备端获取特殊的设备状态时,你应该在发起语音请求时,在请求的上下文中,具体格式请参考:设备状态 Context

# Custom 指令

iFLYOS是以指令与客户端进行交互的,当你的设备希望通过一些自定义的指令对设备进行控制,那么,我们为拦截器提供了这样的能力。你可以在拦截器的响应中将指令发送给IVS,IVS将把数据传送给设备。

IVS协议请参考:设备与IVS的交互约定

# 消息格式

{
	"directive": {
	    "header": {
	        "namespace": "Custom",
	        "name": "Custom",
	        "dialogRequestId": "...",
	        "messageId": "...",
	    },
	    "payload": {
	        "key": "value" // 自定义数据
	    }
	}
}

# Custom 事件

客户端通过上报事件与iFLYOS进行交互,当你的设备希望主动上报信息到iFLYOS,我们会将事件转发到对应的拦截器技能。IVS协议请参考:设备与IVS的交互约定

# 消息格式

{
	"context": [
		// 	参考设备上下文
	],
	"event": {
	    "header": {
	        "namespace": "Custom",
	        "name": "Custom",
	        "messageId": "...",
	    },
	    "payload": {
	        "key": "value" // 自定义数据
	    }
	}
}