สคีมาของช่องสมาร์ทโฮม

action.devices.traits.Channel - ลักษณะเฉพาะนี้เป็นของอุปกรณ์ที่รองรับช่องทีวีในอุปกรณ์สื่อ

คุณควรแชร์ช่องที่พร้อมใช้งานเป็นรายการ 1 รายการต่อผู้ใช้หรือ 1 อุปกรณ์ระหว่าง SYNC ผ่านแอตทริบิวต์ availableChannels รายการนี้ควรประกอบด้วยช่องยอดนิยมหรือช่องยอดนิยมทั้งหมดที่ผู้ใช้หรืออุปกรณ์ได้ติดตาม เราขอแนะนําให้คุณทําให้รายการช่องมีขนาดเล็ก (ไม่เกิน 30 ช่อง) เพื่อให้เวลาในการตอบสนองการค้นหาต่ํา

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

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

แอตทริบิวต์	ประเภท	คำอธิบาย
availableChannels	อาร์เรย์	ต้องระบุ รายการออบเจ็กต์ที่อธิบายช่องทางสื่อที่พร้อมใช้งานสําหรับอุปกรณ์นี้ แต่ละรายการอธิบายช่องที่ผู้ใช้เลือกได้ในอุปกรณ์นี้
[item, ...]	วัตถุ	ช่องทางสื่อที่พร้อมใช้งาน
key	สตริง	ต้องระบุ ตัวระบุที่ไม่ซ้ําสําหรับช่องนี้ ผู้ใช้จะไม่เห็น
names	อาร์เรย์	ต้องระบุ รายชื่อที่ผู้ใช้มองเห็นได้สําหรับช่องนี้
[item, ...]	สตริง	ชื่อช่อง
number	สตริง	ตัวระบุที่ไม่บังคับสําหรับช่องนี้
commandOnlyChannels	บูลีน	(ค่าเริ่มต้น: false) ระบุว่าอุปกรณ์รองรับการสื่อสารทางเดียว (จริง) หรือแบบ 2 ทาง (เท็จ) ตั้งค่าแอตทริบิวต์นี้เป็น "จริง" หากอุปกรณ์ตอบกลับ Intent ของ QUERY หรือสถานะรายงานสําหรับลักษณะนี้ไม่ได้

ตัวอย่าง

อุปกรณ์ที่รองรับ 2 ช่อง

{
  "availableChannels": [
    {
      "key": "ktvu2",
      "names": [
        "Fox",
        "KTVU"
      ],
      "number": "2"
    },
    {
      "key": "abc1",
      "names": [
        "ABC",
        "ABC East"
      ],
      "number": "4-11"
    }
  ]
}

สถานะอุปกรณ์

ไม่มี

คําสั่งของอุปกรณ์

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

action.devices.commands.selectChannel

ตั้งค่าแชแนลปัจจุบันเป็นค่าที่ต้องการ

พารามิเตอร์

เพย์โหลดมีองค์ประกอบอย่างใดอย่างหนึ่งต่อไปนี้

เลือกช่องตามรหัส

พารามิเตอร์	ประเภท	คำอธิบาย
channelCode	สตริง	ต้องระบุ ตัวระบุที่ไม่ซ้ํากันของช่องที่ขอ โดยจับคู่กับ 1 ใน availableChannels
channelName	สตริง	ชื่อง่ายของช่องที่ขอ
channelNumber	สตริง	ตัวระบุที่เป็นตัวเลขสําหรับช่องที่ขอ

เลือกช่องตามจํานวน

พารามิเตอร์	ประเภท	คำอธิบาย
channelNumber	สตริง	ต้องระบุ ตัวระบุที่เป็นตัวเลขสําหรับช่องที่ขอ

ตัวอย่าง

เปลี่ยนเป็น KTVU

{
  "command": "action.devices.commands.selectChannel",
  "params": {
    "channelCode": "ktvu2",
    "channelName": "KTVU"
  }
}

หันไปที่ช่อง 3

{
  "command": "action.devices.commands.selectChannel",
  "params": {
    "channelNumber": "3"
  }
}

ข้อผิดพลาดที่เกี่ยวข้อง

เกิดข้อผิดพลาดขณะเลือกช่องใหม่ในอุปกรณ์

ค่าที่รองรับมีดังต่อไปนี้

noAvailableChannel

noChannelSubscription

channelSwitchFailed

action.devices.commands.relativeChannel

ปรับช่องปัจจุบันตามจํานวนที่เกี่ยวข้อง

พารามิเตอร์

พารามิเตอร์	ประเภท	คำอธิบาย
relativeChannelChange	จำนวนเต็ม	ต้องระบุ จํานวนช่องที่จะเพิ่มหรือลด

ตัวอย่าง

เปลี่ยนเป็นช่องถัดไป

{
  "command": "action.devices.commands.relativeChannel",
  "params": {
    "relativeChannelChange": 1
  }
}

เปลี่ยนเป็นช่องก่อนหน้า

{
  "command": "action.devices.commands.relativeChannel",
  "params": {
    "relativeChannelChange": -1
  }
}

ข้อผิดพลาดที่เกี่ยวข้อง

เกิดข้อผิดพลาดในการปรับช่องของอุปกรณ์

ค่าที่รองรับมีดังต่อไปนี้

channelSwitchFailed

action.devices.commands.returnChannel

กลับไปยังช่องสุดท้าย/ก่อนหน้าที่ผู้ใช้อยู่

พารามิเตอร์

พารามิเตอร์	ประเภท	คำอธิบาย
ไม่มีพร็อพเพอร์ตี้

ตัวอย่าง

กลับไปยังช่องสุดท้าย

{
  "command": "action.devices.commands.returnChannel",
  "params": {}
}

ข้อผิดพลาดที่เกี่ยวข้อง

เกิดข้อผิดพลาดขณะกลับไปยังช่องล่าสุดของอุปกรณ์

ค่าที่รองรับมีดังต่อไปนี้

channelSwitchFailed

อุปกรณ์ ERRORS

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