สคีมาลักษณะของแชนแนลสมาร์ทโฮม

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

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

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

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

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

ตัวอย่าง

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

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

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

ไม่มี

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

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

action.devices.commands.selectChannel

ตั้งค่าแชนแนลปัจจุบันเป็นค่าที่เฉพาะเจาะจง

พารามิเตอร์

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

เลือกแชนแนลตามรหัส

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

เลือกแชนแนลตามหมายเลข

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

ตัวอย่าง

เปลี่ยนเป็น 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

ข้อผิดพลาดของอุปกรณ์

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