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

สนับสนุนการค้นพบอุปกรณ์

จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

ระบบจะสร้างเส้นทางการตอบสนองในเครื่องเมื่อ Google จับคู่อุปกรณ์ที่ควบคุมในเครื่องกับอุปกรณ์ที่ส่งกลับมาในการตอบสนองของ SYNC จากการดําเนินการตามระบบคลาวด์

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

ตั้งค่าข้อมูลการกําหนดค่าการสแกน

ทําตามขั้นตอนต่อไปนี้เพื่อระบุข้อมูลการค้นพบ

  1. เปิดโปรเจ็กต์สมาร์ทโฮมในคอนโซลการดําเนินการ
  2. คลิกการดําเนินการในการนําทางด้านซ้าย
  3. ในส่วนกําหนดค่า SDK ในเครื่อง (ไม่บังคับ) > เพิ่มการกําหนดค่าการสแกนอุปกรณ์ ให้คลิกการกําหนดค่าการสแกนใหม่
  4. เลือกประเภทโปรโตคอลการจับคู่การสแกนจากเมนูแบบเลื่อนลง และป้อนค่าเพื่อให้ Google สแกน

ตารางต่อไปนี้แสดงแอตทริบิวต์ที่คุณเพิ่มได้ โดยอิงตามโปรโตคอลที่คุณต้องการให้ Google สแกนหาอุปกรณ์

mDNS
แอตทริบิวต์ คำอธิบาย ค่าตัวอย่าง
ชื่อบริการ ต้องระบุ ชื่อบริการที่เผยแพร่โดยอุปกรณ์ในรูปแบบ service.domain _http._tcp.local
ชื่อ

ต้องระบุ กรองหาอินสแตนซ์บริการที่ไม่ซ้ํากันในรูปแบบ instance.service.domain

แพลตฟอร์มจะถือว่าค่านี้เป็นนิพจน์ทั่วไปและแสดงผลอุปกรณ์ที่ตรงกัน
my-device-[0-9]{4}\._http\._tcp\.local
UPPP
แอตทริบิวต์ คำอธิบาย ค่าตัวอย่าง
ประเภทบริการ ต้องระบุ ตัวระบุที่สมบูรณ์ของบริการ UPnP ในรูปแบบ domain:service:type:version schemas-upnp-org:service:SwitchPower:1
หอยมุก

ไม่บังคับ ตัวระบุที่ไม่ซ้ํากันขององค์กร

ค่า 24 บิตที่ระบุผู้ผลิตอุปกรณ์ โดยทั่วไป 3 อ็อกเท็ตของที่อยู่ MAC ของอุปกรณ์
1A:2B:3C
UDP
แอตทริบิวต์ คำอธิบาย ค่าตัวอย่าง
ที่อยู่การออกอากาศ ต้องระบุ ที่อยู่ IP ปลายทางสําหรับการประกาศ UDP 255.255.255.255
พอร์ตออกอากาศ ต้องระบุ พอร์ตปลายทางสําหรับการออกอากาศ UDP 5555
ฟังพอร์ต ต้องระบุ ฟังพอร์ตสําหรับการตอบสนองการค้นพบ UDP 5556
แพ็กเก็ต Discovery

ต้องระบุ เพย์โหลดที่จะส่งในการออกอากาศ UDP

จัดรูปแบบเป็นสตริงที่เข้ารหัสเลขฐาน 16 เป็นไบต์
48454C4C4F

อัปเดตการตอบสนอง SYNC สําหรับการดําเนินการตามระบบคลาวด์

Intent ของ SYNC จะรายงานไปยัง Assistant ว่าผู้ใช้ควบคุมอุปกรณ์ใดและมีความสามารถอะไรบ้าง

แพลตฟอร์ม Home Home จะตรวจสอบการตอบสนองของ SYNC จากการตอบสนองในระบบคลาวด์ของการดําเนินการสมาร์ทโฮมและพยายามจับคู่รหัสอุปกรณ์ในช่อง otherDeviceIds กับรหัสการยืนยันที่ได้รับจากเครื่องจัดการ IDENTIFY เพื่อรองรับการดําเนินการตามคําสั่งซื้อในพื้นที่ รายการอุปกรณ์ที่ไม่มีช่อง otherDeviceIds จะไม่รวมอยู่ในการดําเนินการตามคําสั่งซื้อในพื้นที่

ในช่อง otherDeviceIds ของการตอบสนอง SYNC คุณต้องตั้งรหัสอุปกรณ์ของอุปกรณ์ในบ้านอัจฉริยะที่ควบคุมในเครื่องได้ ช่องนี้จะปรากฏที่ระดับ device ในการตอบกลับ Google จะสร้างเส้นทางการดําเนินการตามคําสั่งซื้อในพื้นที่ได้ในอุปกรณ์ที่มีรหัสดังกล่าว

ใช้ช่อง customData เพื่อระบุข้อมูลเพิ่มเติมที่ Google ต้องเชื่อมต่อกับอุปกรณ์แบบสแตนด์อโลนหรือกําหนดเป้าหมายอุปกรณ์ปลายทางผ่านฮับ (เช่น หมายเลขพอร์ตและข้อมูลเฉพาะโปรโตคอลอื่นๆ)

ตัวอย่าง

ข้อมูลโค้ดต่อไปนี้จะแสดงวิธีสร้างแฮนเดิล SYNC

สแตนด์อโลน/ฮับ
{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "agentUserId": "1836.15267389",
    "devices": [{
      "id": "123",
      "type": "action.devices.types.OUTLET",
      "traits": [
        "action.devices.traits.OnOff"
      ],
      "name": {
        "name": "Night light"
      },
      "willReportState": false,
      "otherDeviceIds": [{
        "deviceId": "local-device-id"
      }],
      "customData": {
        "port": 5555,
        "authToken": "..."
      }
    }]
  }
}