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

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

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

SDK อุปกรณ์

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

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

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

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

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

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

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

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

เปิด Playground

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

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

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

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

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

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

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

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

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

  1. ในแผงรายการอุปกรณ์ ให้เลือกอุปกรณ์เสมือนที่ต้องการกําหนดค่า
  2. ในแผงข้อมูลอุปกรณ์ ให้เลือกแท็บ SUV และกําหนดค่าสิ่งต่อไปนี้
    • เปิดใช้: เปิดหรือปิดใช้ SUV (ไม่ท้าทาย) ในอุปกรณ์
    • ประเภทคําถาม: ระบุว่า SUV ต้องมีการรับทราบอย่างชัดแจ้งหรือไม่ (ackacked) หรือหมายเลขประจําตัวส่วนบุคคล (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

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

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

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

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

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

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

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

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

เมื่อคุณโต้ตอบกับอุปกรณ์เสมือน 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 ดูเอกสารอ้างอิงรูปแบบของแต่ละเมธอด

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

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

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

แสดงความคิดเห็นและรายงานปัญหา

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

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