สคีมาลักษณะ TransportControl สมาร์ทโฮม

action.devices.traits.TransportControl - ลักษณะนี้ใช้สำหรับอุปกรณ์ที่ควบคุมการเล่นสื่อได้ (เช่น เล่นเพลงต่อขณะที่หยุดชั่วคราว)

แอตทริบิวต์อุปกรณ์

อุปกรณ์ที่มีลักษณะนี้อาจรายงานแอตทริบิวต์ต่อไปนี้เป็นส่วนหนึ่งของการดำเนินการ SYNC ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent SYNC ได้ที่การดำเนินการตาม Intent

Attributes ประเภท คำอธิบาย
transportControlSupportedCommands อาร์เรย์

ต้องระบุ

รายการสตริงที่อธิบายคำสั่งการควบคุมการรับส่งข้อมูลที่รองรับในอุปกรณ์นี้

[item, ...] String

คำสั่งที่รองรับ

ค่าที่รองรับ

CAPTION_CONTROL
NEXT
PAUSE
PREVIOUS
RESUME
SEEK_RELATIVE
SEEK_TO_POSITION
SET_REPEAT
SHUFFLE
STOP

ตัวอย่าง

อุปกรณ์ที่รองรับคำสั่งการเล่น

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

สถานะอุปกรณ์

ไม่มี

คำสั่งของอุปกรณ์

อุปกรณ์ที่มีลักษณะนี้อาจตอบสนองต่อคําสั่งต่อไปนี้ซึ่งเป็นส่วนหนึ่งของการดำเนินการ EXECUTE ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent EXECUTE ได้ที่การดำเนินการตาม Intent

action.devices.commands.mediaStop

หยุดเล่นสื่อชั่วคราว

คำสั่งนี้ต้องใช้แอตทริบิวต์ต่อไปนี้
{
  "transportControlSupportedCommands": [
    "STOP"
  ]
}

พารามิเตอร์

พารามิเตอร์ ประเภท คำอธิบาย

ไม่มีพร็อพเพอร์ตี้

ตัวอย่าง

ไม่มีพารามิเตอร์

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

action.devices.commands.mediaNext

ข้ามไปยังรายการสื่อถัดไป

คำสั่งนี้ต้องใช้แอตทริบิวต์ต่อไปนี้
{
  "transportControlSupportedCommands": [
    "NEXT"
  ]
}

พารามิเตอร์

พารามิเตอร์ ประเภท คำอธิบาย

ไม่มีพร็อพเพอร์ตี้

ตัวอย่าง

ไม่มีพารามิเตอร์

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

action.devices.commands.mediaPrevious

ข้ามไปยังรายการสื่อก่อนหน้า

คำสั่งนี้ต้องใช้แอตทริบิวต์ต่อไปนี้
{
  "transportControlSupportedCommands": [
    "PREVIOUS"
  ]
}

พารามิเตอร์

พารามิเตอร์ ประเภท คำอธิบาย

ไม่มีพร็อพเพอร์ตี้

ตัวอย่าง

ไม่มีพารามิเตอร์

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

action.devices.commands.mediaPause

หยุดเล่นสื่อชั่วคราว

คำสั่งนี้ต้องใช้แอตทริบิวต์ต่อไปนี้
{
  "transportControlSupportedCommands": [
    "PAUSE"
  ]
}

พารามิเตอร์

พารามิเตอร์ ประเภท คำอธิบาย

ไม่มีพร็อพเพอร์ตี้

ตัวอย่าง

ไม่มีพารามิเตอร์

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

action.devices.commands.mediaResume

เล่นสื่อต่อ

คำสั่งนี้ต้องใช้แอตทริบิวต์ต่อไปนี้
{
  "transportControlSupportedCommands": [
    "RESUME"
  ]
}

พารามิเตอร์

พารามิเตอร์ ประเภท คำอธิบาย

ไม่มีพร็อพเพอร์ตี้

ตัวอย่าง

ไม่มีพารามิเตอร์

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

action.devices.commands.mediaSeekRelative

กรอไปยังตำแหน่งแบบสัมพัทธ์

คำสั่งนี้ต้องใช้แอตทริบิวต์ต่อไปนี้
{
  "transportControlSupportedCommands": [
    "SEEK_RELATIVE"
  ]
}

พารามิเตอร์

พารามิเตอร์ ประเภท คำอธิบาย
relativePositionMs จำนวนเต็ม

ต้องระบุ

มิลลิวินาทีของจำนวนการกรอไปข้างหน้า (int บวก) หรือกรอกลับ (int ลบ)

ตัวอย่าง

กรอไปข้างหน้า 10 วินาที

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

กรอกลับ 10 วินาที

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

action.devices.commands.mediaSeekToPosition

ไปยังตำแหน่งสัมบูรณ์

คำสั่งนี้ต้องใช้แอตทริบิวต์ต่อไปนี้
{
  "transportControlSupportedCommands": [
    "SEEK_TO_POSITION"
  ]
}

พารามิเตอร์

พารามิเตอร์ ประเภท คำอธิบาย
absPositionMs จำนวนเต็ม

ต้องระบุ

มิลลิวินาทีของตำแหน่งสัมบูรณ์ที่จะกรอไป

ตัวอย่าง

กรอไปที่ 30 วินาที

{
  "command": "action.devices.commands.mediaSeekToPosition",
  "params": {
    "absPositionMs": 30000
  }
}

action.devices.commands.mediaRepeatMode

ตั้งค่าโหมดเล่นซ้ำ

คำสั่งนี้ต้องใช้แอตทริบิวต์ต่อไปนี้
{
  "transportControlSupportedCommands": [
    "SET_REPEAT"
  ]
}

พารามิเตอร์

พารามิเตอร์ ประเภท คำอธิบาย
isOn บูลีน

ต้องระบุ

จริงเพื่อเปิดโหมดเล่นซ้ำ และเท็จเพื่อปิดโหมดเล่นซ้ำ

isSingle บูลีน

(ค่าเริ่มต้น: false)

หากระบุไว้ "จริง" หมายถึงการเปิดโหมดเล่นซ้ำรายการเดียว และ "เท็จ" หมายถึงการเปิดโหมดเล่นซ้ำปกติ (เช่น เพลย์ลิสต์)

ตัวอย่าง

เกิดซ้ำใน

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

ปิดการทําซ้ำ

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

เล่นแทร็กเดียวซ้ำ

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

action.devices.commands.mediaShuffle

สุ่มเพลย์ลิสต์ปัจจุบัน

คำสั่งนี้ต้องใช้แอตทริบิวต์ต่อไปนี้
{
  "transportControlSupportedCommands": [
    "SHUFFLE"
  ]
}

พารามิเตอร์

พารามิเตอร์ ประเภท คำอธิบาย

ไม่มีพร็อพเพอร์ตี้

ตัวอย่าง

ไม่มีพารามิเตอร์

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

action.devices.commands.mediaClosedCaptioningOn

เปิดคำบรรยายแทนเสียง

คำสั่งนี้ต้องใช้แอตทริบิวต์ต่อไปนี้
{
  "transportControlSupportedCommands": [
    "CAPTION_CONTROL"
  ]
}

พารามิเตอร์

พารามิเตอร์ ประเภท คำอธิบาย
closedCaptioningLanguage String

ภาษาหรือภาษาท้องถิ่นสำหรับคำบรรยายแทนเสียง

userQueryLanguage String

ภาษาหรือภาษาท้องถิ่นสําหรับคําค้นหาของผู้ใช้

ตัวอย่าง

เปิดคำบรรยายแทนเสียงเป็นภาษาอังกฤษ

{
  "command": "action.devices.commands.mediaClosedCaptioningOn",
  "params": {
    "closedCaptioningLanguage": "en"
  }
}

เปิดคำบรรยายแทนเสียงภาษาเกาหลี

{
  "command": "action.devices.commands.mediaClosedCaptioningOn",
  "params": {
    "closedCaptioningLanguage": "ko-KR"
  }
}

เปิดคำบรรยายแทนเสียงภาษาเกาหลีที่มีคำค้นหาของผู้ใช้เป็นภาษาอังกฤษแบบอเมริกัน

{
  "command": "action.devices.commands.mediaClosedCaptioningOn",
  "params": {
    "closedCaptioningLanguage": "ko-KR",
    "userQueryLanguage": "en-US"
  }
}

action.devices.commands.mediaClosedCaptioningOff

ปิดคำบรรยายแทนเสียง

คำสั่งนี้ต้องใช้แอตทริบิวต์ต่อไปนี้
{
  "transportControlSupportedCommands": [
    "CAPTION_CONTROL"
  ]
}

พารามิเตอร์

พารามิเตอร์ ประเภท คำอธิบาย

ไม่มีพร็อพเพอร์ตี้

ตัวอย่าง

ปิดคำบรรยายแทนเสียง

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

ข้อผิดพลาดของอุปกรณ์

ดูรายการข้อผิดพลาดและข้อยกเว้นทั้งหมด