สนามเด็กเล่น 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 ทางเว็บประกอบด้วยแผงสามแผง:

  • รายการอุปกรณ์จะแสดงอุปกรณ์เสมือนทั้งหมดของคุณ คุณสามารถเลือกอุปกรณ์เสมือนจริงเครื่องใดเครื่องหนึ่งเพื่อดูข้อมูลแล้วสร้างอุปกรณ์เสมือนผ่านทางแผงนี้
  • ข้อมูลอุปกรณ์แสดงข้อมูลของอุปกรณ์เสมือนที่เลือก นอกจากนี้ คุณยังแก้ไขข้อมูลนี้และนําอุปกรณ์เสมือนที่เลือกออก ผ่านแผงดังกล่าวได้ด้วย
  • พื้นที่บันทึก แสดงบันทึกการโต้ตอบระหว่าง 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 ต้องตอบรับอย่างชัดแจ้งหรือไม่ (รับทราบความจําเป็น) หรือขอหมายเลขประจําตัวส่วนบุคคล (pinneeded)
    • PIN: PIN ที่ถูกต้อง
    • การจัดการ PIN ที่ไม่ถูกต้อง: เมื่อ PIN ไม่ถูกต้อง ให้ถามผู้ใช้อีกครั้งไหม แล้วหากตอบผิด ให้แจ้ง
รูปนี้แสดงเครื่องมือ UX สําหรับเปิดใช้งานคุณลักษณะการยืนยันของผู้ใช้รองในอุปกรณ์ที่เลือกใน Google Home Playground

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

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

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

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

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

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

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

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

ผู้แก้ไขการตอบกลับการซิงค์

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

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

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

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

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

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

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

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

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

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

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

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

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

รายการบันทึกแต่ละรายการจะเป็นอาร์เรย์ 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