สคีมาของ Smart Home TransportControl Trait
action.devices.traits.TransportControl
- ลักษณะเฉพาะนี้มีผลกับอุปกรณ์ที่ควบคุมการเล่นสื่อได้ (เช่น กลับมาเล่นเพลงต่อในขณะหยุดชั่วคราว)
แอตทริบิวต์อุปกรณ์
อุปกรณ์ที่มีลักษณะเฉพาะนี้อาจรายงานแอตทริบิวต์ต่อไปนี้เป็นส่วนหนึ่งของการดําเนินการ SYNC
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ SYNC
ได้ที่การดําเนินการตามความตั้งใจ
แอตทริบิวต์ | ประเภท | คำอธิบาย |
---|---|---|
transportControlSupportedCommands |
อาร์เรย์ |
ต้องระบุ รายการสตริงที่อธิบายคําสั่งควบคุมการขนส่งที่รองรับในอุปกรณ์นี้ |
[item, ...] |
สตริง |
คําสั่งที่รองรับ ค่าที่รองรับมีดังต่อไปนี้
|
ตัวอย่าง
อุปกรณ์ที่รองรับคําสั่งเล่น
{ "transportControlSupportedCommands": [ "NEXT", "PREVIOUS", "PAUSE", "STOP", "RESUME" ] }
สถานะอุปกรณ์
ไม่มี
คําสั่งของอุปกรณ์
อุปกรณ์ที่มีลักษณะเฉพาะนี้อาจตอบสนองต่อคําสั่งต่อไปนี้ซึ่งเป็นส่วนหนึ่งของการดําเนินการ EXECUTE
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ EXECUTE
ได้ที่การดําเนินการตามความตั้งใจ
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 |
จำนวนเต็ม |
ต้องระบุ มิลลิวินาทีของจํานวนไปข้างหน้า (ค่าบวกบวก) หรือค่าย้อนหลัง (ค่าลบติดลบ) |
ตัวอย่าง
กรอไปข้างหน้า 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 |
สตริง |
ภาษาหรือสถานที่สําหรับคําบรรยาย |
userQueryLanguage |
สตริง |
ภาษาหรือภาษาของคําค้นหาของผู้ใช้ |
ตัวอย่าง
เปิดคําบรรยายเป็นภาษาอังกฤษ
{ "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": {} }