สคีมาของ Smart Home TransportControl Trait

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

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

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

แอตทริบิวต์	ประเภท	คำอธิบาย
transportControlSupportedCommands	อาร์เรย์	ต้องระบุ รายการสตริงที่อธิบายคําสั่งควบคุมการขนส่งที่รองรับในอุปกรณ์นี้
[item, ...]	สตริง	คําสั่งที่รองรับ ค่าที่รองรับมีดังต่อไปนี้ CAPTION_CONTROL NEXT PAUSE PREVIOUS RESUME SEEK_RELATIVE SEEK_TO_POSITION SET_REPEAT SHUFFLE STOP

ตัวอย่าง

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

{
  "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	บูลีน	(ค่าเริ่มต้น: 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	สตริง	ภาษาหรือสถานที่สําหรับคําบรรยาย
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": {}
}

อุปกรณ์ ERRORS

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