สคีมาลักษณะ TransportControl สมาร์ทโฮม
action.devices.traits.TransportControl - ลักษณะนี้ใช้สำหรับอุปกรณ์ที่ควบคุมการเล่นสื่อได้ (เช่น เล่นเพลงต่อขณะที่หยุดชั่วคราว)
แอตทริบิวต์อุปกรณ์
อุปกรณ์ที่มีลักษณะนี้อาจรายงานแอตทริบิวต์ต่อไปนี้เป็นส่วนหนึ่งของการดำเนินการ SYNC ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent SYNC ได้ที่การดำเนินการตาม Intent
| Attributes | ประเภท | คำอธิบาย | 
|---|---|---|
transportControlSupportedCommands | 
    อาร์เรย์ | 
       ต้องระบุ รายการสตริงที่อธิบายคำสั่งการควบคุมการรับส่งข้อมูลที่รองรับในอุปกรณ์นี้  | 
  
[item, ...] | 
    String | 
       คำสั่งที่รองรับ ค่าที่รองรับ 
  | 
  
ตัวอย่าง
อุปกรณ์ที่รองรับคำสั่งการเล่น
{
  "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 | 
    บูลีน | 
       (ค่าเริ่มต้น:  หากระบุไว้ "จริง" หมายถึงการเปิดโหมดเล่นซ้ำรายการเดียว และ "เท็จ" หมายถึงการเปิดโหมดเล่นซ้ำปกติ (เช่น เพลย์ลิสต์)  | 
  
ตัวอย่าง
เกิดซ้ำใน
{
  "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": {}
}