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ợ:

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

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

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": {}
}

LỖI thiết bị

Xem danh sách đầy đủ lỗi và ngoại lệ.