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