ยินดีต้อนรับสู่ศูนย์นักพัฒนาแอป Google Home ซึ่งเป็นปลายทางใหม่สำหรับการเรียนรู้วิธีพัฒนาการดำเนินการของสมาร์ทโฮม

หน้านี้ได้รับการแปลโดย Cloud Translation API

action.devices.QUERY

Intent นี้จะค้นหาการดำเนินการตามคำสั่งซื้อเพื่อดูสถานะปัจจุบันของอุปกรณ์ เช่น อุปกรณ์ออนไลน์และเข้าถึงได้หรือไม่

การตอบกลับ QUERY ของคุณควรแสดงเฉพาะข้อมูลสถานะ การอัปเดตแอตทริบิวต์และลักษณะของอุปกรณ์ได้รับการจัดการโดย คำตอบ SYNC รายการ

โปรดดูรายละเอียดเพิ่มเติมที่หัวข้อค้นหาและเรียกใช้

รูปแบบคำขอ

ช่อง	ประเภท	คำอธิบาย
`requestId`	String	ต้องระบุ รหัสของคำขอ
`inputs`	อาร์เรย์	ต้องระบุ รายการอินพุตที่ตรงกับคำขอ Intent
`[item, ...]`	ออบเจ็กต์	ประเภทและเพย์โหลดที่เชื่อมโยงกับคำขอ Intent
`intent`		ต้องระบุ (ค่าคงที่: `"action.devices.QUERY"`) ประเภทคำขอ Intent
`payload`	ออบเจ็กต์	ต้องระบุ เพย์โหลดคำขอ QUERY
`devices`	อาร์เรย์	ต้องระบุ รายการอุปกรณ์เป้าหมาย
`[item, ...]`	ออบเจ็กต์	อุปกรณ์เป้าหมายที่จะค้นหา
`id`	String	ต้องระบุ รหัสอุปกรณ์ ตามรหัสที่ระบุไว้ใน SYNC
`customData`	ออบเจ็กต์	หากออบเจ็กต์ customData แบบทึบแสงอยู่ใน SYNC ระบบจะส่งไปที่ออบเจ็กต์ดังกล่าว

ตัวอย่าง

คำขอ Intent ของ QUERY

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "inputs": [
    {
      "intent": "action.devices.QUERY",
      "payload": {
        "devices": [
          {
            "id": "123",
            "customData": {
              "fooValue": 74,
              "barValue": true,
              "bazValue": "foo"
            }
          },
          {
            "id": "456",
            "customData": {
              "fooValue": 12,
              "barValue": false,
              "bazValue": "bar"
            }
          }
        ]
      }
    }
  ]
}

รูปแบบการตอบกลับ

ช่อง	ประเภท	คำอธิบาย
`requestId`	String	ต้องระบุ รหัสของคำขอที่เกี่ยวข้อง
`payload`	ออบเจ็กต์	ต้องระบุ เพย์โหลดการตอบกลับด้วยความตั้งใจ
`errorCode`	String	รหัสข้อผิดพลาดของธุรกรรมทั้งธุรกรรมสำหรับการตรวจสอบสิทธิ์ที่ล้มเหลวและระบบของนักพัฒนาซอฟต์แวร์ไม่พร้อมใช้งาน สำหรับข้อผิดพลาดของอุปกรณ์แต่ละเครื่อง ให้ใช้รหัสข้อผิดพลาดภายในออบเจ็กต์อุปกรณ์
`debugString`	String	ข้อผิดพลาดโดยละเอียดที่จะไม่แสดงต่อผู้ใช้ แต่อาจบันทึกหรือใช้ในระหว่างการพัฒนา
`devices`	ออบเจ็กต์	ต้องระบุ แผนที่ของอุปกรณ์ รหัสอุปกรณ์ของนักพัฒนาซอฟต์แวร์ Maps กับออบเจ็กต์พร็อพเพอร์ตี้สถานะ
`<string>`	ออบเจ็กต์	สถานะของอุปกรณ์
`online`	บูลีน	ต้องระบุ ระบุว่าอุปกรณ์ออนไลน์ (ซึ่งก็คือที่เข้าถึงได้) หรือไม่
`status`	String	ต้องระบุ ผลลัพธ์ของการดำเนินการค้นหา ค่าที่รองรับ `SUCCESS` ยืนยันว่าการค้นหาสำเร็จแล้ว `OFFLINE` อุปกรณ์เป้าหมายอยู่ในสถานะออฟไลน์หรือเข้าถึงไม่ได้ `EXCEPTIONS` มีปัญหาหรือการแจ้งเตือนที่เกี่ยวข้องกับการค้นหา การค้นหาอาจสำเร็จหรือล้มเหลว โดยปกติสถานะประเภทนี้จะตั้งไว้เมื่อคุณต้องการส่งข้อมูลเพิ่มเติมเกี่ยวกับอุปกรณ์ที่เชื่อมต่อเครื่องอื่น `ERROR` ไม่พบอุปกรณ์เป้าหมาย
`errorCode`	String	ขยายสถานะ ERROR จากรหัสข้อผิดพลาดที่กำหนดไว้ล่วงหน้าหากจำเป็น ซึ่งจะแมปกับข้อผิดพลาดที่ผู้ใช้เห็น

ตัวอย่าง

การตอบสนอง Intent ของ QUERY

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "devices": {
      "123": {
        "on": true,
        "online": true,
        "status": "SUCCESS"
      },
      "456": {
        "on": true,
        "online": true,
        "status": "SUCCESS",
        "brightness": 80,
        "color": {
          "spectrumRgb": 16711935
        }
      }
    }
  }
}