ยินดีต้อนรับสู่ศูนย์นักพัฒนาซอฟต์แวร์ Google Home ซึ่งเป็นจุดหมายใหม่เกี่ยวกับวิธีพัฒนาการดําเนินการสําหรับบ้านอัจฉริยะ หมายเหตุ: คุณจะสร้างการดําเนินการต่างๆ ต่อไปในคอนโซลการดําเนินการ

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

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

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