สคีมาลักษณะเฉพาะของช่องอัจฉริยะ

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

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

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

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

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

ตัวอย่าง

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

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

อุปกรณ์ STATES

ไม่ต้องแจ้งเตือนเลย

อุปกรณ์ COMMANDS

อุปกรณ์ที่มีลักษณะเฉพาะนี้อาจตอบสนองต่อคําสั่งต่อไปนี้ในฐานะส่วนหนึ่งของการดําเนินการ 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

อุปกรณ์ ERRORS

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