Giản đồ đặc điểm TransportControl của nhà thông minh
action.devices.traits.TransportControl
– Đặc điểm này được dùng cho các thiết bị có thể điều khiển chế độ phát nội dung nghe nhìn (ví dụ: tiếp tục phát nhạc khi đang tạm dừng).
Thuộc tính thiết bị
Các thiết bị có đặc điểm này có thể báo cáo các thuộc tính sau đây trong quá trình thao tác SYNC
. Để tìm hiểu thêm về cách xử lý ý định SYNC
, hãy xem phần Thực hiện ý định.
Thuộc tính | Loại | Mô tả |
---|---|---|
transportControlSupportedCommands |
Mảng |
Bắt buộc. Danh sách các chuỗi mô tả các lệnh điều khiển truyền tải được hỗ trợ trên thiết bị này. |
[item, ...] |
String |
Các lệnh được hỗ trợ. Các giá trị được hỗ trợ:
|
Ví dụ
Thiết bị hỗ trợ các lệnh phát
{ "transportControlSupportedCommands": [ "NEXT", "PREVIOUS", "PAUSE", "STOP", "RESUME" ] }
Trạng thái thiết bị
Không có.
LỆNH của thiết bị
Các thiết bị có đặc điểm này có thể phản hồi các lệnh sau đây trong quá trình hoạt động EXECUTE
. Để tìm hiểu thêm về cách xử lý ý định EXECUTE
, hãy xem phần Thực hiện ý định.
action.devices.commands.mediaStop
Tạm dừng phát nội dung nghe nhìn.
Lệnh này yêu cầu các thuộc tính sau:{ "transportControlSupportedCommands": [ "STOP" ] }
Thông số
Thông số | Loại | Mô tả |
---|---|---|
Không có thuộc tính nào |
Ví dụ
Không có tham số
{ "command": "action.devices.commands.mediaStop", "params": {} }
action.devices.commands.mediaNext
Chuyển đến mục nội dung nghe nhìn tiếp theo.
Lệnh này yêu cầu các thuộc tính sau:{ "transportControlSupportedCommands": [ "NEXT" ] }
Thông số
Thông số | Loại | Mô tả |
---|---|---|
Không có thuộc tính nào |
Ví dụ
Không có tham số
{ "command": "action.devices.commands.mediaNext", "params": {} }
action.devices.commands.mediaPrevious
Chuyển đến mục nội dung nghe nhìn trước đó.
Lệnh này yêu cầu các thuộc tính sau:{ "transportControlSupportedCommands": [ "PREVIOUS" ] }
Thông số
Thông số | Loại | Mô tả |
---|---|---|
Không có thuộc tính nào |
Ví dụ
Không có tham số
{ "command": "action.devices.commands.mediaPrevious", "params": {} }
action.devices.commands.mediaPause
Tạm dừng phát nội dung nghe nhìn.
Lệnh này yêu cầu các thuộc tính sau:{ "transportControlSupportedCommands": [ "PAUSE" ] }
Thông số
Thông số | Loại | Mô tả |
---|---|---|
Không có thuộc tính nào |
Ví dụ
Không có tham số
{ "command": "action.devices.commands.mediaPause", "params": {} }
action.devices.commands.mediaResume
Tiếp tục phát nội dung nghe nhìn.
Lệnh này yêu cầu các thuộc tính sau:{ "transportControlSupportedCommands": [ "RESUME" ] }
Thông số
Thông số | Loại | Mô tả |
---|---|---|
Không có thuộc tính nào |
Ví dụ
Không có tham số
{ "command": "action.devices.commands.mediaResume", "params": {} }
action.devices.commands.mediaSeekRelative
Tua đến một vị trí tương đối.
Lệnh này yêu cầu các thuộc tính sau:{ "transportControlSupportedCommands": [ "SEEK_RELATIVE" ] }
Thông số
Thông số | Loại | Mô tả |
---|---|---|
relativePositionMs |
Số nguyên |
Bắt buộc. Số mili giây của lượng thời gian cần tìm kiếm về phía trước (số nguyên dương) hoặc về phía sau (số nguyên âm). |
Ví dụ
Tua đi 10 giây
{ "command": "action.devices.commands.mediaSeekRelative", "params": { "relativePositionMs": 10000 } }
Tua lại 10 giây
{ "command": "action.devices.commands.mediaSeekRelative", "params": { "relativePositionMs": -10000 } }
action.devices.commands.mediaSeekToPosition
Tìm đến một vị trí tuyệt đối.
Lệnh này yêu cầu các thuộc tính sau:{ "transportControlSupportedCommands": [ "SEEK_TO_POSITION" ] }
Thông số
Thông số | Loại | Mô tả |
---|---|---|
absPositionMs |
Số nguyên |
Bắt buộc. Mili giây của vị trí tuyệt đối cần tua đến. |
Ví dụ
Tua đến 30 giây
{ "command": "action.devices.commands.mediaSeekToPosition", "params": { "absPositionMs": 30000 } }
action.devices.commands.mediaRepeatMode
Đặt chế độ phát lặp lại.
Lệnh này yêu cầu các thuộc tính sau:{ "transportControlSupportedCommands": [ "SET_REPEAT" ] }
Thông số
Thông số | Loại | Mô tả |
---|---|---|
isOn |
Boolean |
Bắt buộc. True để bật chế độ lặp lại, false để tắt chế độ lặp lại. |
isSingle |
Boolean |
(Mặc định: Nếu được chỉ định, true có nghĩa là bật chế độ phát lặp một mục, false có nghĩa là bật chế độ phát lặp thông thường (ví dụ: danh sách phát). |
Ví dụ
Lặp lại vào
{ "command": "action.devices.commands.mediaRepeatMode", "params": { "isOn": true } }
Tắt tính năng lặp lại
{ "command": "action.devices.commands.mediaRepeatMode", "params": { "isOn": false } }
Lặp lại một bản nhạc
{ "command": "action.devices.commands.mediaRepeatMode", "params": { "isOn": true, "isSingle": true } }
action.devices.commands.mediaShuffle
Phát ngẫu nhiên danh sách phát hiện tại.
Lệnh này yêu cầu các thuộc tính sau:{ "transportControlSupportedCommands": [ "SHUFFLE" ] }
Thông số
Thông số | Loại | Mô tả |
---|---|---|
Không có thuộc tính nào |
Ví dụ
Không có tham số
{ "command": "action.devices.commands.mediaShuffle", "params": {} }
action.devices.commands.mediaClosedCaptioningOn
Bật phụ đề.
Lệnh này yêu cầu các thuộc tính sau:{ "transportControlSupportedCommands": [ "CAPTION_CONTROL" ] }
Thông số
Thông số | Loại | Mô tả |
---|---|---|
closedCaptioningLanguage |
String |
Ngôn ngữ hoặc khu vực cho phụ đề. |
userQueryLanguage |
String |
Ngôn ngữ hoặc ngôn ngữ bản địa cho cụm từ tìm kiếm của người dùng. |
Ví dụ
Bật phụ đề chi tiết bằng tiếng Anh
{ "command": "action.devices.commands.mediaClosedCaptioningOn", "params": { "closedCaptioningLanguage": "en" } }
Bật phụ đề chi tiết bằng tiếng Hàn
{ "command": "action.devices.commands.mediaClosedCaptioningOn", "params": { "closedCaptioningLanguage": "ko-KR" } }
Bật phụ đề tiếng Hàn khi cụm từ tìm kiếm của người dùng là tiếng Anh Mỹ
{ "command": "action.devices.commands.mediaClosedCaptioningOn", "params": { "closedCaptioningLanguage": "ko-KR", "userQueryLanguage": "en-US" } }
action.devices.commands.mediaClosedCaptioningOff
Tắt phụ đề.
Lệnh này yêu cầu các thuộc tính sau:{ "transportControlSupportedCommands": [ "CAPTION_CONTROL" ] }
Thông số
Thông số | Loại | Mô tả |
---|---|---|
Không có thuộc tính nào |
Ví dụ
Tắt phụ đề
{ "command": "action.devices.commands.mediaClosedCaptioningOff", "params": {} }