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

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

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

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

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

แอตทริบิวต์	Type	คำอธิบาย
availableChannels	อาร์เรย์	ต้องระบุ รายการออบเจ็กต์ที่อธิบายช่องทางสื่อที่พร้อมใช้งานสําหรับอุปกรณ์นี้ แต่ละรายการจะอธิบายแชแนลที่ผู้ใช้เลือกได้ในอุปกรณ์นี้
[item, ...]	ออบเจ็กต์	ช่องทางสื่อพร้อมให้บริการ
key	สตริง	ต้องระบุ ตัวระบุที่ไม่ซ้ําสําหรับช่องนี้ ไม่เปิดเผยต่อผู้ใช้
names	อาร์เรย์	ต้องระบุ รายการชื่อที่ผู้ใช้มองเห็นได้สําหรับช่องนี้
[item, ...]	สตริง	ชื่อช่อง
number	สตริง	ตัวระบุที่ไม่บังคับสําหรับช่องนี้
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

ตั้งค่าช่องปัจจุบันให้เป็นค่าที่ระบุ

พารามิเตอร์

เพย์โหลดมีดังต่อไปนี้

เลือกช่องโดยใช้รหัส

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

เลือกช่องตามหมายเลข

พารามิเตอร์	Type	คำอธิบาย
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

ปรับช่องปัจจุบันตามจํานวนสัมพัทธ์

พารามิเตอร์

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

ตัวอย่าง

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

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

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

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

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

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

ค่าที่รองรับ:

channelSwitchFailed

action.devices.commands.returnChannel

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

พารามิเตอร์

พารามิเตอร์	Type	คำอธิบาย
ไม่มีพร็อพเพอร์ตี้

ตัวอย่าง

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

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

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

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

ค่าที่รองรับ:

channelSwitchFailed

อุปกรณ์ ERRORS

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