สนามเด็กเล่น Google Home

SDK อุปกรณ์

Google Home Playground คือเว็บแอปพลิเคชันที่จำลองโปรเจ็กต์บ้านอัจฉริยะที่มีประเภทและลักษณะอุปกรณ์ที่กำหนดค่าได้ คุณสร้างอุปกรณ์เสมือน แก้ไขแอตทริบิวต์และสถานะของอุปกรณ์ ดูอุปกรณ์เหล่านี้ใน Google Home Graph และนำเข้าหรือส่งออกการกำหนดค่าอุปกรณ์ได้

ลิงก์บัญชีให้เสร็จสมบูรณ์

ในการใช้ Google Home Playground ขอแนะนำให้คุณลิงก์เครื่องมือกับบัญชีของคุณก่อน เปิด Google Home app (GHA) ในโทรศัพท์ แล้วทำตามขั้นตอนการลิงก์บัญชี

  1. คลิกไอคอนบวก (+) ที่มุมซ้ายบน
  2. เลือกตั้งค่าอุปกรณ์ > ใช้กับ Google ได้
  3. ค้นหาการดำเนินการที่มีชื่อว่า Google Home Playground
  4. เลือกการดำเนินการ และ GHA จะนำคุณไปยังหน้าลงชื่อเข้าใช้ คลิกลงชื่อเข้าใช้ด้วย Google แล้วเลือกบัญชีของคุณเพื่อลงชื่อเข้าใช้
  5. คลิกปุ่มให้สิทธิ์เพื่ออนุญาตการลิงก์บัญชี
รูปนี้แสดงขั้นตอนการลิงก์บัญชีแอป Google Home สำหรับการเชื่อมต่อ Google Home Playground

เมื่อลิงก์บัญชีเสร็จแล้ว ชุดอุปกรณ์เสมือนเริ่มต้นจะปรากฏใน GHA เพื่อให้คุณโต้ตอบด้วย

ภาพนี้แสดงรายการอุปกรณ์เริ่มต้นที่ปรากฏขึ้นเมื่อผู้ใช้ลิงก์ Google Home Playground กับบัญชีของตนสำเร็จ

ลงชื่อเข้าใช้

เปิด Google Home Playground โดยคลิกปุ่มด้านล่าง:

เปิด Playground

คลิกลงชื่อเข้าใช้ด้วย Google โปรดลงชื่อเข้าใช้ด้วยบัญชีเดียวกันกับที่ใช้ใน GHA เพื่อลิงก์บัญชีให้เสร็จสมบูรณ์

รูปนี้แสดงสถานะเริ่มต้นของ Google Home Playground และไฮไลต์ปุ่มลงชื่อเข้าใช้ที่มุมบนขวา

หลังจากลงชื่อเข้าใช้ Google Home Playground จะแสดงอุปกรณ์เสมือนที่จัดเก็บไว้ใน Home Graph

รูปนี้แสดงรายการอุปกรณ์ ข้อมูลอุปกรณ์ และพื้นที่บันทึกของ
            มุมมองเริ่มต้นของ Google Home Playground

UI บนเว็บประกอบด้วยแผง 3 แผง ดังนี้

  • รายการอุปกรณ์แสดงอุปกรณ์เสมือนทั้งหมด คุณสามารถเลือกอุปกรณ์เสมือนจริงบางอย่างเพื่อดูข้อมูลและสร้างอุปกรณ์เสมือนผ่านแผงควบคุมนี้
  • ข้อมูลอุปกรณ์แสดงข้อมูลของอุปกรณ์เสมือนที่เลือก คุณยังแก้ไขข้อมูลนี้และนำอุปกรณ์เสมือนที่เลือกออกผ่านแผงได้อีกด้วย
  • พื้นที่บันทึกจะแสดงบันทึกการโต้ตอบระหว่าง Google Home Playground และ Home Graph คุณจะขยายบันทึกเพื่อตรวจสอบเพย์โหลดคำขอและการตอบกลับเพื่อแก้ปัญหาได้

อุปกรณ์เสมือนจริง

ดูข้อมูลอุปกรณ์เสมือน

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

  • ข้อมูลพื้นฐาน: พร็อพเพอร์ตี้ระดับบนสุดของอุปกรณ์ ซึ่งรวมถึงประเภทอุปกรณ์ รหัส และชื่อ
  • คุณลักษณะ: ลักษณะที่รองรับของอุปกรณ์
  • แอตทริบิวต์: แอตทริบิวต์เฉพาะลักษณะเฉพาะของอุปกรณ์
  • สถานะ: สถานะของอุปกรณ์ทั้งหมด
  • SUV: การกำหนดค่าการยืนยันผู้ใช้รองของอุปกรณ์

แก้ไขข้อมูลอุปกรณ์เสมือน

นอกจากดูข้อมูลของอุปกรณ์เสมือนแล้ว คุณยังแก้ไขข้อมูลของอุปกรณ์ที่จัดเก็บไว้ใน Home Graph ได้โดยตรงผ่านแผงข้อมูลอุปกรณ์

แก้ไขลักษณะที่รองรับ

  1. เลือกแท็บคุณลักษณะ คลิกปุ่มแก้ไข
  2. ในแผงป๊อปอัป คุณจะเห็นลักษณะที่รองรับในปัจจุบันของอุปกรณ์ รวมถึงคุณลักษณะที่จะเพิ่มได้ ใช้ปุ่มลูกศร (arrow_forward/arrow_back) เพื่อเพิ่มหรือนำลักษณะที่รองรับสำหรับอุปกรณ์ออก
  3. เมื่ออัปเดตลักษณะที่รองรับเสร็จแล้ว ให้คลิกบันทึก และระบบจะนำลักษณะที่อัปเดตไปใช้กับ Home Graph
  4. คุณดูการอัปเดตลักษณะเหล่านี้ได้ในพื้นที่บันทึก
รูปนี้แสดงเครื่องมือ UX สำหรับเพิ่มหรือลบลักษณะที่รองรับในอุปกรณ์ที่เลือกไว้ใน Google Home Playground

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

  1. เลือกแท็บแอตทริบิวต์ และแก้ไขแอตทริบิวต์สำหรับลักษณะเฉพาะที่อุปกรณ์รองรับ
  2. เมื่อแก้ไขเสร็จแล้ว ให้กด Enter จากนั้นการเปลี่ยนแปลงแอตทริบิวต์จะมีผลกับ Home Graph
  3. คุณดูแอตทริบิวต์ที่อัปเดตเหล่านี้ได้ในพื้นที่บันทึก

แก้ไขสถานะของอุปกรณ์

  1. เลือกแท็บรัฐ แล้วแก้ไขรัฐโดยตรง การเปลี่ยนแปลงสถานะจะมีผลกับ Home Graph
  2. คุณดูการแก้ไขสถานะเหล่านี้ได้ในพื้นที่บันทึก

เพิ่มการยืนยันผู้ใช้รองลงในอุปกรณ์เสมือน

คุณจะเพิ่ม SUV ไปยังอุปกรณ์เสมือน รวมถึงกำหนดค่าประเภทการท้าและลักษณะการทำงานที่เกี่ยวข้องในอุปกรณ์แต่ละเครื่องได้ คุณเพิ่ม SUV ไปยังอุปกรณ์เสมือน รวมถึงกำหนดค่าประเภทการท้าและลักษณะการทำงานที่เกี่ยวข้องในอุปกรณ์แต่ละเครื่องได้

กำหนดค่า SUV ในอุปกรณ์

  1. ในแผงรายการอุปกรณ์ ให้เลือกอุปกรณ์เสมือนที่ต้องการกำหนดค่า
  2. ในแผงข้อมูลอุปกรณ์ ให้เลือกแท็บ SUV และกำหนดค่าสิ่งต่อไปนี้
    • เปิดใช้: จะเปิดหรือปิดใช้ SUV ในอุปกรณ์ (ไม่ผ่านการทดสอบ)
    • ประเภทการพิสูจน์: พิจารณาว่า SUV ต้องมีการรับทราบอย่างชัดแจ้ง (ackNeeded) หรือหมายเลขประจำตัวส่วนบุคคล (pinNeeded)
    • PIN: PIN ที่ถูกต้อง
    • การจัดการ PIN ที่ไม่ถูกต้อง: เมื่อ PIN ไม่ถูกต้อง ให้ถามผู้ใช้อีกครั้ง และหากไม่ยอมรับ ให้ตอบกลับหากไม่ถูกต้อง
รูปนี้แสดงเครื่องมือ UX สำหรับเปิดใช้ลักษณะการยืนยันผู้ใช้รองในอุปกรณ์ที่เลือกไว้ใน Playground ของ Google Home

ระบุอุปกรณ์ที่เปิดใช้ SUV

ในแผงรายการอุปกรณ์ ไอคอนคีย์ คีย์จะแสดงอยู่ข้างอุปกรณ์ที่พร้อมใช้งาน SUV แต่ละเครื่อง

รูปนี้แสดงอุปกรณ์ที่แนะนำให้เปิดใช้การยืนยันผู้ใช้รอง

รายการลักษณะต่อไปนี้ต้องใช้ SUV

สร้างอุปกรณ์เสมือนใหม่

  1. ในแผงรายการอุปกรณ์ ให้คลิกเพิ่มอุปกรณ์
  2. ในแผงป๊อปอัป ให้เลือกประเภทอุปกรณ์และป้อนชื่ออุปกรณ์สำหรับอุปกรณ์เครื่องใหม่ หรือจะเลือกชุดอุปกรณ์ที่กำหนดไว้ล่วงหน้าที่ต้องการเพิ่มก็ได้
  3. เมื่อทำตามขั้นตอนทั้งหมดเรียบร้อยแล้ว ระบบจะเพิ่มอุปกรณ์ใหม่ไปยัง Home Graph
รูปนี้แสดงเครื่องมือ UX สำหรับเพิ่มประเภทอุปกรณ์ใหม่ใน Google Home Playground

นำอุปกรณ์เสมือนออก

  1. ในแผงรายการอุปกรณ์ ให้เลือกอุปกรณ์ที่ต้องการนำออก จากนั้นเลือกแท็บข้อมูลพื้นฐานในแผงข้อมูลอุปกรณ์ และจากนั้นเลือกแท็บข้อมูลพื้นฐานในแผงข้อมูลอุปกรณ์ แล้วคลิกไอคอนถังขยะนำอุปกรณ์ออกที่ด้านล่าง
  2. ยืนยันการนำอุปกรณ์ออกในการแจ้งเตือนแบบป๊อปอัป
  3. เมื่อคุณยืนยันการนำอุปกรณ์ออกแล้ว ระบบจะนำอุปกรณ์ออกจาก Home Graph
รูปนี้แสดงเครื่องมือ UX สำหรับการนำประเภทอุปกรณ์เสมือนใน Google Home Playground ออก

เครื่องมือแก้ไขการตอบสนองการซิงค์

คุณสามารถตรวจสอบหรืออัปเดตการตอบกลับการซิงค์ได้ใน Google Home Playground คลิกเครื่องมือแก้ไขการตอบกลับการซิงค์เพื่อเปิด IDE ที่ฝัง

รูปนี้แสดงปุ่มสำหรับเปิดตัวแก้ไขการตอบกลับการซิงค์

แก้ไข หรือคัดลอกและวางการตอบกลับการซิงค์ แล้วคลิกบันทึกเพื่อใช้การเปลี่ยนแปลงเพื่อดูวิธีการทำงานในระบบนิเวศของ Google Home

รูปนี้แสดงหน้าต่างสำหรับแก้ไขการตอบสนองการซิงค์

นำเข้าและส่งออกอุปกรณ์เสมือน

หากต้องการแก้ปัญหาหรือจำลองปัญหา คุณสามารถส่งออกอุปกรณ์เสมือนพร้อมสถานะไปยังไฟล์ และแชร์ไฟล์กับผู้อื่นเพื่อนำเข้าและจำลองอุปกรณ์เสมือนของคุณ

รูปนี้แสดงเครื่องมือ UX สำหรับการนำเข้าและส่งออกอุปกรณ์เสมือนใน Google Home Playground

ส่งออกอุปกรณ์เสมือนไปยังไฟล์

  1. คลิก เพื่อส่งออกอุปกรณ์เสมือนไปยังไฟล์
  2. ป้อนชื่อไฟล์ที่ต้องการส่งออก แล้วคลิกตกลง
  3. เมื่อคุณป้อนชื่อไฟล์แล้ว เบราว์เซอร์จะดาวน์โหลดไฟล์ของอุปกรณ์เสมือนที่ส่งออก

นำเข้าอุปกรณ์เสมือนจากไฟล์

  1. คลิก เพื่อนำเข้าอุปกรณ์เสมือนจากไฟล์
  2. เลือกไฟล์ที่ต้องการนำเข้า แล้วคลิกตกลง
  3. เมื่อคุณยืนยันไฟล์ที่จะนำเข้าแล้ว Google Home Playground จะนำเข้าอุปกรณ์เสมือนพร้อมด้วยสถานะจากไฟล์ และอัปเดตข้อมูลและสถานะของอุปกรณ์ที่นำเข้าใน Home Graph

ตรวจสอบบันทึกการโต้ตอบ

เมื่อคุณโต้ตอบกับอุปกรณ์เสมือน Google Home Playground จะนำการเปลี่ยนแปลงของคุณไปใช้กับ Home Graph โดยอัตโนมัติ ระบบจะบันทึกการโต้ตอบกับ Home Graph ไว้ในแผงพื้นที่บันทึก ซึ่งคุณสามารถขยายแต่ละรายการเพื่อตรวจสอบเพย์โหลดคำขอและการตอบกลับของ Home Graph API ได้

รายการบันทึกแต่ละรายการจะเป็นอาร์เรย์ JSON ซึ่งมีองค์ประกอบของโครงสร้างต่อไปนี้

{
  "uri": string,
  "request": object,
  "response": object
}
ช่อง ประเภท คำอธิบาย
uri string URL ของการเรียก API Home Graph
request object เนื้อหาคำขอของการเรียก API Home Graph ดูรูปแบบของแต่ละวิธีได้ในเอกสารประกอบข้อมูลอ้างอิง เอกสารอ้างอิง
response object เนื้อหาการตอบสนองของการเรียก API Home Graph ดูรูปแบบของแต่ละวิธีได้ในเอกสารประกอบข้อมูลอ้างอิง เอกสารอ้างอิง

ดูประเภทและลักษณะอุปกรณ์ที่รองรับ

ไอคอนความช่วยเหลือเครื่องหมายคำถามที่ด้านขวาบนจะแสดงประเภทอุปกรณ์และรายการลักษณะปัจจุบันที่ Google Home Playground รองรับ

รูปนี้แสดงเครื่องมือ UX สำหรับเพิ่มประเภทอุปกรณ์ใหม่ใน Google Home Playground

รายงานปัญหา

เราอยากฟังความคิดเห็นจากคุณ รายงานปัญหาโดยใช้ไอคอนเครื่องหมายอัศเจรีย์ ความคิดเห็นที่ด้านขวาบน

รูปนี้แสดงไอคอนสำหรับแสดงความคิดเห็นและรายงานปัญหาใน Google Home Playground