สคีมาลักษณะ 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": {} }