Hướng dẫn điều khiển từ xa về nội dung nghe nhìn trong nhà thông minh
action.devices.types.REMOTECONTROL – Điều khiển từ xa về nội dung nghe nhìn được dùng để điều khiển các thiết bị truyền thông. Ví dụ về loại thiết bị này bao gồm thiết bị trung tâm, điều khiển từ xa đa năng và bộ điều khiển nội dung đa phương tiện.
Loại này cho biết thiết bị nhận được biểu tượng Điều khiển nội dung đa phương tiện và một số từ đồng nghĩa và bí danh.
Khả năng của thiết bị
Tham khảo tài liệu về đặc điểm tương ứng cho thông tin chi tiết về việc triển khai, chẳng hạn như các thuộc tính và trạng thái mà dịch vụ của bạn sẽ hỗ trợ cũng như cách tạo các phản hồi EXECUTE và QUERY.
Đặc điểm bắt buộc
Đây là những đặc điểm và lệnh bắt buộc, nếu phù hợp với
thiết bị. Nếu thiết bị của bạn không hỗ trợ những đặc điểm này, hãy nhập mã lỗi của
functionNotSupported trong phản hồi QUERY hoặc EXECUTE. Xem
Lỗi và ngoại lệ để biết thêm thông tin.
| Đặc điểm | Lệnh |
|---|---|
action.devices.traits.AppSelector |
|
action.devices.traits.InputSelector |
|
action.devices.traits.MediaState |
|
action.devices.traits.OnOff |
|
action.devices.traits.TransportControl |
|
action.devices.traits.Volume |
|
Đặc điểm được đề xuất
Bạn nên dùng những đặc điểm này (nếu phù hợp với thiết bị của mình). Tuy nhiên, bạn có thể thoải mái kết hợp tất cả các đặc điểm có sẵn để phù hợp nhất với hiện tại của mình chức năng của sản phẩm.
action.devices.traits.Channelaction.devices.traits.Modes- Chế độ TV (chẳng hạn như Rạp chiếu phim hoặc Thể thao)
action.devices.traits.Toggles
Yêu cầu về chất lượng
- Độ trễ: phải nhỏ hơn hoặc bằng 3000 mili giây.
- Độ tin cậy: phải lớn hơn hoặc bằng 97%.
Thiết bị mẫu: Điều khiển từ xa đơn giản cho nội dung nghe nhìn
Phần này chứa các tải trọng ý định mẫu đại diện cho một "Điều khiển từ xa" chung dựa trên loại thiết bị và đặc điểm nêu trên. Nếu bạn thêm hoặc xoá các đặc điểm trong quá trình triển khai, sửa đổi câu trả lời của bạn sao cho phù hợp để phản ánh những thay đổi đó.
Phản hồi SYNC mẫu
{
"requestId": "6894439706274654512",
"inputs": [
{
"intent": "action.devices.SYNC"
}
]
}
{
"requestId": "6894439706274654512",
"payload": {
"agentUserId": "user123",
"devices": [
{
"id": "123",
"type": "action.devices.types.REMOTECONTROL",
"traits": [
"action.devices.traits.Channel",
"action.devices.traits.AppSelector",
"action.devices.traits.InputSelector",
"action.devices.traits.MediaState",
"action.devices.traits.OnOff",
"action.devices.traits.TransportControl",
"action.devices.traits.Volume"
],
"name": {
"name": "Simple media remote"
},
"willReportState": true,
"attributes": {
"transportControlSupportedCommands": [
"NEXT",
"PREVIOUS",
"PAUSE",
"STOP",
"RESUME",
"CAPTION_CONTROL"
],
"availableApplications": [
{
"key": "youtube",
"names": [
{
"name_synonym": [
"Youtube",
"Youtube_en"
],
"lang": "en"
}
]
}
],
"availableChannels": [
{
"key": "ktvu2",
"names": [
"Fox",
"KTVU"
],
"number": "2"
},
{
"key": "abc1",
"names": [
"ABC",
"ABC East"
],
"number": "702.4-11"
}
],
"availableInputs": [
{
"key": "hdmi_1",
"names": [
{
"name_synonym": [
"HDMI 1",
"DVD Player"
],
"lang": "en"
}
]
},
{
"key": "hdmi_2",
"names": [
{
"name_synonym": [
"HDMI 2",
"TV"
],
"lang": "en"
}
]
}
],
"orderedInputs": false,
"volumeMaxLevel": 11,
"volumeCanMuteAndUnmute": true,
"volumeDefaultPercentage": 6,
"levelStepSize": 2,
"commandOnlyVolume": false,
"supportActivityState": true,
"supportPlaybackState": true
},
"deviceInfo": {
"manufacturer": "smart-home-inc",
"model": "hs1234",
"hwVersion": "3.2",
"swVersion": "11.4"
}
}
]
}
}
Phản hồi QUERY mẫu
{
"requestId": "6894439706274654514",
"inputs": [
{
"intent": "action.devices.QUERY",
"payload": {
"devices": [
{
"id": "123"
}
]
}
}
]
}
{
"requestId": "6894439706274654514",
"payload": {
"devices": {
"123": {
"status": "SUCCESS",
"online": true,
"on": true,
"currentApplication": "youtube",
"currentInput": "hdmi_1",
"currentVolume": 10,
"isMuted": false,
"activityState": "ACTIVE",
"playbackState": "PAUSED"
}
}
}
}
Lệnh EXECUTE mẫu
appInstall
Để biết thêm thông tin chi tiết về các tham số lệnh,
hãy xem
action.devices.traits.AppSelector
tham chiếu.
{
"requestId": "6894439706274654522",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.appInstall",
"params": {
"newApplication": "youtube"
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654522",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"currentApplication": "youtube"
}
}
]
}
}
appSearch
Để biết thêm thông tin chi tiết về các tham số lệnh,
hãy xem
action.devices.traits.AppSelector
tham chiếu.
{
"requestId": "6894439706274654524",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.appSearch",
"params": {
"newApplication": "youtube"
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654524",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"currentApplication": "youtube"
}
}
]
}
}
appSelect
Để biết thêm thông tin chi tiết về các tham số lệnh,
hãy xem
action.devices.traits.AppSelector
tham chiếu.
{
"requestId": "6894439706274654526",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.appSelect",
"params": {
"newApplication": "youtube"
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654526",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"currentApplication": "youtube"
}
}
]
}
}
SetInput
Để biết thêm thông tin chi tiết về các tham số lệnh,
hãy xem
action.devices.traits.InputSelector
tham chiếu.
{
"requestId": "6894439706274654528",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.SetInput",
"params": {
"newInput": "hdmi_2"
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654528",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"currentInput": "hdmi_2"
}
}
]
}
}
PreviousInput
Để biết thêm thông tin chi tiết về các tham số lệnh,
hãy xem
action.devices.traits.InputSelector
tham chiếu.
{
"requestId": "6894439706274654532",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.PreviousInput"
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654532",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"currentInput": "hdmi_2"
}
}
]
}
}
NextInput
Để biết thêm thông tin chi tiết về các tham số lệnh,
hãy xem
action.devices.traits.InputSelector
tham chiếu.
{
"requestId": "6894439706274654530",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.NextInput"
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654530",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"currentInput": "hdmi_2"
}
}
]
}
}
OnOff
Để biết thêm thông tin chi tiết về các tham số lệnh,
hãy xem
action.devices.traits.OnOff
tham chiếu.
{
"requestId": "6894439706274654534",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.OnOff",
"params": {
"on": true
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654534",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"on": true
}
}
]
}
}
mediaClosedCaptioningOff
Để biết thêm thông tin chi tiết về các tham số lệnh,
hãy xem
action.devices.traits.TransportControl
tham chiếu.
{
"requestId": "6894439706274654536",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.mediaClosedCaptioningOff"
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654536",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"playbackState": "PLAYING"
}
}
]
}
}
mediaClosedCaptioningOn
Để biết thêm thông tin chi tiết về các tham số lệnh,
hãy xem
action.devices.traits.TransportControl
tham chiếu.
{
"requestId": "6894439706274654538",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.mediaClosedCaptioningOn",
"params": {
"closedCaptioningLanguage": "en"
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654538",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"playbackState": "PLAYING"
}
}
]
}
}
mediaNext
Để biết thêm thông tin chi tiết về các tham số lệnh,
hãy xem
action.devices.traits.TransportControl
tham chiếu.
{
"requestId": "6894439706274654540",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.mediaNext"
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654540",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"playbackState": "FAST_FORWARDING"
}
}
]
}
}
mediaPause
Để biết thêm thông tin chi tiết về các tham số lệnh,
hãy xem
action.devices.traits.TransportControl
tham chiếu.
{
"requestId": "6894439706274654542",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.mediaPause"
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654542",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"playbackState": "PAUSED"
}
}
]
}
}
mediaPrevious
Để biết thêm thông tin chi tiết về các tham số lệnh,
hãy xem
action.devices.traits.TransportControl
tham chiếu.
{
"requestId": "6894439706274654544",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.mediaPrevious"
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654544",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"playbackState": "REWINDING"
}
}
]
}
}
mediaResume
Để biết thêm thông tin chi tiết về các tham số lệnh,
hãy xem
action.devices.traits.TransportControl
tham chiếu.
{
"requestId": "6894439706274654546",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.mediaResume"
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654546",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"playbackState": "PLAYING"
}
}
]
}
}
mediaStop
Để biết thêm thông tin chi tiết về các tham số lệnh,
hãy xem
action.devices.traits.TransportControl
tham chiếu.
{
"requestId": "6894439706274654548",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.mediaStop"
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654548",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"playbackState": "STOPPED"
}
}
]
}
}
tắt tiếng
Để biết thêm thông tin chi tiết về các tham số lệnh,
hãy xem
action.devices.traits.Volume
tham chiếu.
{
"requestId": "6894439706274654552",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.mute",
"params": {
"mute": true
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654552",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"currentVolume": 10,
"isMuted": true
}
}
]
}
}
setVolume
Để biết thêm thông tin chi tiết về các tham số lệnh,
hãy xem
action.devices.traits.Volume
tham chiếu.
{
"requestId": "6894439706274654550",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.setVolume",
"params": {
"volumeLevel": 11
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654550",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"currentVolume": 11,
"isMuted": false
}
}
]
}
}