Giản đồ đặc điểm của Smart Home TransportControl

action.devices.traits.TransportControl – Đặc điểm này được sử 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 trong khi tạm dừng).

ATTRIBUTE của thiết bị

Những thiết bị có đặc điểm này có thể báo cáo những điều sau trong thao tác SYNC. Để tìm hiểu tìm hiểu thêm về cách xử lý ý định SYNC, hãy xem 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 phương thức 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ợ:

CAPTION_CONTROL
NEXT
PAUSE
PREVIOUS
RESUME
SEEK_RELATIVE
SEEK_TO_POSITION
SET_REPEAT
SHUFFLE
STOP

Ví dụ

Thiết bị hỗ trợ các lệnh phát

{
  "transportControlSupportedCommands": [
    "NEXT",
    "PREVIOUS",
    "PAUSE",
    "STOP",
    "RESUME"
  ]
}

Thiết bị STATES

Không có.

lệnh của thiết bị

Những thiết bị có đặc điểm này có thể phản hồi với những đặc điểm sau các lệnh trong thao tác EXECUTE. Để tìm hiểu tìm hiểu thêm về cách xử lý ý định EXECUTE, hãy xem 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"
  ]
}

Tham số

Tham 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"
  ]
}

Tham số

Tham 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"
  ]
}

Tham số

Tham 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"
  ]
}

Tham số

Tham 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"
  ]
}

Tham số

Tham 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"
  ]
}

Tham số

Tham số Loại Mô tả
relativePositionMs Số nguyên

Bắt buộc.

Số mili giây tới (số nguyên dương) hoặc lùi (số nguyên âm) cần tìm kiếm.

Ví dụ

Tua đi 10 giây

{
  "command": "action.devices.commands.mediaSeekRelative",
  "params": {
    "relativePositionMs": 10000
  }
}

Tìm kiếm lùi lại 10 giây

{
  "command": "action.devices.commands.mediaSeekRelative",
  "params": {
    "relativePositionMs": -10000
  }
}

action.devices.commands.mediaSeekToPosition

Tua đế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"
  ]
}

Tham số

Tham 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 tìm.

Ví dụ

Tìm kiếm trong 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"
  ]
}

Tham số

Tham 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: false)

Nếu được chỉ định, true có nghĩa là bật chế độ lặp lại một mục, còn false nghĩa là bật chế độ lặp lại thông thường (ví dụ như danh sách phát).

Ví dụ

Bật chế độ lặp lại

{
  "command": "action.devices.commands.mediaRepeatMode",
  "params": {
    "isOn": true
  }
}

Tắt chế độ 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"
  ]
}

Tham số

Tham 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"
  ]
}

Tham số

Tham số Loại Mô tả
closedCaptioningLanguage String

Ngôn ngữ hoặc khu vực của phụ đề.
userQueryLanguage String

Ngôn ngữ hoặc khu vực cho truy vấn 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ụ đề chi tiết bằng tiếng Hàn với cụm từ tìm kiếm của người dùng bằng 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"
  ]
}

Tham số

Tham số Loại Mô tả

Không có thuộc tính nào

Ví dụ

Tắt phụ đề chi tiết

{
  "command": "action.devices.commands.mediaClosedCaptioningOff",
  "params": {}
}

Thiết bị ERRORS

Xem toàn bộ danh sách lỗi và ngoại lệ.