Google Home Plugin for Android Studio ออกแบบและสร้างขึ้นสำหรับนักพัฒนาซอฟต์แวร์ Google Home Platform ปลั๊กอินนี้ช่วยให้คุณเข้าถึง Google Assistant Simulator, Cloud Logging และเครื่องมืออื่นๆ เพื่อลดความซับซ้อนของขั้นตอนการพัฒนาสมาร์ทโฮม

ประกาศด้านความปลอดภัย
หากไม่ต้องการให้ Android Studio จัดเก็บข้อมูลลับและรหัสผ่าน ให้ทําตามขั้นตอนต่อไปนี้
- คลิกไฟล์ แล้วคลิกการตั้งค่า...
- ในลักษณะที่ปรากฏและลักษณะการทำงาน ให้ขยายการตั้งค่าระบบ แล้วคลิกรหัสผ่าน
- เลือกไม่บันทึก ลืมรหัสผ่านหลังจากรีสตาร์ท

ฟีเจอร์
เครื่องมือจำลอง Assistant
หากต้องการทดสอบว่าอุปกรณ์ในบ้านอัจฉริยะทำงานอย่างถูกต้องกับระบบนิเวศของ Google Home หรือไม่ คุณสามารถโต้ตอบกับ Assistant Simulator ได้ทุกเมื่อโดยไม่ต้องออกจาก Android Studio
Assistant Simulator คล้ายกับเครื่องจำลอง Assistant ที่มีอยู่ในคอนโซล Actions on Google Console โดยช่วยให้คุณควบคุมอุปกรณ์ได้อย่างง่ายดายโดยพิมพ์คำค้นหา เช่น "เปิดไฟ" ภายใน Android Studio Assistant Simulator จะตอบกลับด้วยข้อความตามคำสั่งของคุณ เช่น "เอาละ กำลังเปิดไฟ"

ดู Cloud Logging
Google Cloud Logging ให้ข้อมูลการแก้ไขข้อบกพร่องและเมตริกหลักเพื่อให้ข้อมูลเชิงลึกเกี่ยวกับการใช้งานการดำเนินการของคุณ Google Home Plugin จะแสดงข้อความ Cloud Logging แบบเรียลไทม์ข้างรหัสของคุณระหว่างการแก้ปัญหาเพื่อให้การพัฒนาง่ายขึ้น
คุณสามารถแสดงบันทึกแบบเรียลไทม์หรือเลือกช่วงวันที่ก็ได้

การอ่านออกเสียงเป็นกลุ่ม
การตอบสนองต่อ Assistant Simulator เสียงเดียวไม่เป็นตัวกำหนด เช่น คำตอบอาจเป็นวลีใดก็ได้ต่อไปนี้
- รับทราบ กำลังเปิดไฟ 2 ดวง
- ได้เลย กำลังเปิดไฟ 2 ดวง
- รับทราบ กำลังเปิดไฟ 2 ดวง
- ได้เลย กำลังเปิดไฟ 2 ดวง
หากต้องการเรียกใช้การทดสอบอัตโนมัติและยืนยันวิธีการทำงานของการผสานรวม Google กับคำตอบต่างๆ เหล่านี้ คุณสามารถส่งการพูดแบบกลุ่มไปยัง Assistant Simulator โดยการเรียกใช้สคริปต์เสียงพูด เมื่อบันทึกสคริปต์แล้ว คุณจะรวบรวมคำตอบและทำการทดสอบหลายรายการกับคำค้นหาได้
โปรแกรมดูกราฟของหน้าแรก
โปรแกรมดูกราฟ Home ช่วยให้คุณแสดงสถานะของอุปกรณ์และเปิดใช้ชุดทดสอบ Google Home ในเบราว์เซอร์ได้
ผู้ดูบันทึก Android Debug Bridge (adb)
ผู้ดูบันทึก Adb เป็นเครื่องมือในการดูและวิเคราะห์ไฟล์บันทึก เช่น ไฟล์บันทึกของอุปกรณ์ Matter, บันทึกของ Google Home และบันทึกของ Android
ติดตั้ง
หากต้องการติดตั้ง Google Home Plugin ใน Android Studio ให้ทำตามขั้นตอนต่อไปนี้
- ดาวน์โหลดหรืออัปเดต Android Studio ดาวน์โหลด Android Studio
- ไปที่ไฟล์ > การตั้งค่า (Android Studio > ค่ากำหนด ใน MacOS)
- ในส่วนปลั๊กอิน ให้ไปที่ตลาดกลาง และค้นหา
google home
- ติดตั้งเครื่องมือและรีสตาร์ท Android Studio
หรือคุณจะดาวน์โหลดปลั๊กอินจาก JetBrains Marketplace โดยตรงก็ได้
ตั้งค่า
เมื่อติดตั้งปลั๊กอินแล้ว คุณจะต้องทำตามขั้นตอนต่อไปนี้ให้เสร็จสมบูรณ์ก่อนจึงจะใช้ Assistant Simulator และดู Cloud Logging ได้
ลงชื่อเข้าใช้ด้วย Google
คุณลงชื่อเข้าใช้บัญชีนักพัฒนาแอปได้จากแผง Google Home โดยอนุญาตให้ Android Studio สื่อสารกับบริการของ Google ในนามของคุณ
คลิกแท็บ Google Home ในคอลัมน์แท็บแนวตั้งทางด้านซ้ายของหน้าต่าง Android Studio
ในส่วน Sign in with ให้คลิก Google เพื่อเปิดเบราว์เซอร์
เลือกบัญชีที่ลิงก์กับอุปกรณ์ในบ้านอัจฉริยะ
ในหน้าการให้สิทธิ์ลงชื่อเข้าใช้ด้วย Google ให้คลิกอนุญาต
ปิดหน้าต่างเบราว์เซอร์แล้วกลับไปที่ Android Studio
ตอนนี้คุณควรเข้าสู่ระบบแล้ว แต่จะเห็นตัวเลือกออกจากระบบ
เลือกโปรเจ็กต์ที่อยู่ในระบบคลาวด์
หลังจากลงชื่อเข้าใช้ ให้เลือกโครงการจากเมนูแบบเลื่อนลง หากต้องการกรองรายการโปรเจ็กต์ ให้พิมพ์นิพจน์ตัวกรอง เช่น matter
แล้วกด Enter
เมนูแบบเลื่อนลงโปรเจ็กต์จะโหลด 100 โปรเจ็กต์แรกตามตัวกรอง ระบบจะเก็บรักษาสิ่งที่คุณเลือกไว้เมื่อออกจาก Android Studio

หากต้องการความช่วยเหลือเกี่ยวกับตัวกรองโปรเจ็กต์ โปรดดูพารามิเตอร์การค้นหาในข้อมูลอ้างอิงของ Google Cloud
ใช้โปรแกรมจำลอง Assistant
หากต้องการเปิด Assistant Simulator ใน Android Studio ให้คลิก Utterances Panel จากแผง Google Home Plugin

การส่งการค้นหาไปยัง Assistant Simulator ทำได้หลายวิธี ต่อไป เราจะไปดูแต่ละตัวเลือก
พิมพ์คำค้นหาและรวบรวมคำตอบ
หากต้องการโต้ตอบกับ Assistant Simulator ให้พิมพ์คำค้นหาและกด Enter
คุณส่งการค้นหาอีกครั้งได้โดยคลิกไอคอนส่งอีกครั้ง
ที่ท้ายการค้นหาหลังจากส่งคำค้นหาอย่างน้อย 1 รายการ ให้คลิก
เล่นซ้ำเพื่อเรียกใช้คำค้นหาอีกครั้งและตรวจสอบคำตอบของคุณ แผงถ้อยคำจะติดตามคำค้นหาและการตอบกลับของคุณในแคชที่เก็บไว้ การเล่นซ้ำจะเพิ่มคำตอบใหม่ลงในแคชภายในนี้เท่านั้น และจะไม่สร้างคำค้นหาซ้ำทุกครั้งที่คุณคลิกปุ่ม
คลิก
บันทึกเพื่อบันทึกการค้นหาและคำตอบที่คุณป้อนในแผงถ้อยคำ การโต้ตอบจะแปลงเป็น JSON ในรูปแบบต่อไปนี้ask
: คำถามของคุณanswers
: อาร์เรย์ของคำตอบ Assistant Simulator ที่เป็นไปได้
คุณแก้ไขไฟล์ JSON นี้ได้ใน Android Studio
{
"collected": false,
"lines": [
{
"ask": "turn lights on",
"answers": [
"OK, turning 2 lights on.",
"Sure, turning on 2 lights."
]
}
]
}
รวบรวมคำตอบแบบกลุ่ม
จากแผง Google Home Plugin ให้คลิกไฟล์ Utterances เพื่อเปิดไฟล์ JSON ที่บันทึกไว้ในแท็บใหม่ สำหรับ Select Path คุณสามารถเลือกไฟล์หรือโฟลเดอร์ หากคุณเลือกโฟลเดอร์ รวบรวมและทดสอบจะทำงานกับไฟล์การเปล่งเสียงทั้งหมด.json
ในโฟลเดอร์นั้น
คุณเปิดหลายแท็บสำหรับไฟล์เดียวกันหรือคนละไฟล์ได้ เช่น lights
, lights(1)
และ plug
แถบสถานะจะแสดงผลการทดสอบครั้งล่าสุด (หากมี) จุดสีเหลืองหรือสีเขียวที่บ่งชี้ว่ามีการรวบรวมไฟล์หรือไม่ และเส้นทางของไฟล์ .json
ของเสียงพูด หลังจากคลิก รวบรวม Assistant Simulator จะเรียกใช้การค้นหา
คุณจะได้รับแจ้งเมื่อมีการรวบรวมคำตอบใหม่ และแถบสถานะจะแสดงตัวนับขณะประมวลผลการค้นหาของคุณ

เมื่อรวบรวมเสร็จสมบูรณ์แล้ว แถบสถานะจะอัปเดตด้วยเครื่องหมายถูกสีเขียวที่ด้านหน้าเส้นทาง .json
และไฟล์คำพูดจะแสดงคำตอบที่เป็นไปได้

{
"collected": true,
"lines": [
{
"ask": "turn lights on",
"answers": [
"OK, turning 2 lights on.",
"Sure, turning on 2 lights.",
"Sure, turning 2 lights on.",
"Got it, turning 2 lights on.",
"Alright, turning on 2 lights.",
"OK, turning on 2 lights.",
"Got it, turning on 2 lights.",
"Alright, turning 2 lights on."
]
}
]
}
หากคุณหยุดการรวบรวมข้อมูลก่อนกำหนด ระบบจะไม่ทำเครื่องหมายเส้นทาง .json
ว่ารวบรวมแล้ว
ทดสอบการพูดแบบกลุ่ม
เมื่อรวบรวมคำตอบแล้ว ให้คลิกAssistant Simulator จะคาดหวังการตอบสนองที่บันทึกไว้ในไฟล์ JSON ของคุณ หากการทดสอบแสดงผลการตอบกลับที่ยังไม่ได้รวบรวม คุณจะได้รับการแจ้งเตือนที่คล้ายกับการตอบกลับต่อไปนี้
ทดสอบเพื่อเล่นคำค้นหาซ้ำ ตลอดจนตรวจสอบคำตอบและบันทึก เมื่อทดสอบการพูดออกเสียงแบบกลุ่มExpected one of: "Got it, turning on
2 lights."

สถานการณ์นี้บ่งบอกว่าทดสอบไม่สำเร็จ มิเช่นนั้น Assistant Simulator จะเรียกใช้การค้นหาแต่ละรายการแล้วแสดงผลคำตอบ การตรวจสอบ จะแสดงใน แถบสถานะ หากการทดสอบสำเร็จ

ดู Cloud Logging
หากต้องการเปิดแท็บโปรเจ็กต์ในหน้าต่างเครื่องมือบันทึก Cloud ให้คลิกบันทึกของ Cloud จากแผง Google Home Plugin คุณเปิดแท็บบันทึกระบบคลาวด์แยกกัน สำหรับแต่ละโปรเจ็กต์ได้

คำค้นหา
สำหรับโปรเจ็กต์ที่เลือก คุณยังสามารถกรองบันทึกโดยใช้ช่องข้อความค้นหาได้อีกด้วย
เช่น หากต้องการกรองบันทึกสำหรับคีย์เวิร์ด light

เลือกใช้ QL เพื่อใช้ภาษาของการค้นหาการบันทึก

ตัวอย่างบางส่วนของคำถาม QL ที่จะช่วยในการเริ่มต้นใช้งานมีดังนี้
severity = (DEBUG OR INFO OR NOTICE OR WARNING OR ERROR OR CRITICAL OR ALERT OR EMERGENCY) AND resource.type="assistant_action_project" AND timestamp > "2022-04-07T00:40:18Z"
jsonPayload.executionLog.executionResults.actionResults.action.trait = "TRAIT_ON_OFF"
jsonPayload.executionLog.executionResults.actionResults.action.actionType = "ONOFF_ON"
การค้นหาวันที่และเวลา
นอกจากนี้ การค้นหาบันทึกตามวันที่ยังไม่บังคับและเปิดใช้ได้โดยคลิกหลังและก่อน คุณสามารถพิมพ์รูปแบบวันที่และเวลาในช่องข้อความที่มีให้ เช่น 5/11/22, 12:37 PM
หรือใช้เครื่องมือเลือกวันที่ เพื่อเลือกวันที่แล้วป้อนเวลาในช่องข้อความ
- หากต้องการเลือกวันที่หลังจาก
5/1/22
ให้เลือกหลังและคลิกไอคอนวันที่ - หากต้องการเลือกวันที่ก่อนวันที่
5/1/22
ให้เลือกก่อนและคลิกไอคอนวันที่ - หากต้องการเลือกวันที่ระหว่าง
5/1/22
ถึง6/30/22
ให้เลือกก่อนและหลัง แล้วเลือกวันที่จากไอคอนวันที่
เลือกเรียลไทม์เพื่อดึงข้อมูลบันทึกโปรเจ็กต์ที่เผยแพร่อยู่ คลิกหยุดเพื่อสิ้นสุดฟีดแบบเรียลไทม์
ระดับความรุนแรง
หรือจะเลือกความรุนแรงระดับต่ำจากเมนูแบบเลื่อนลงก็ได้
ผลการค้นหา
คลิก
ดึงข้อมูลเพื่อส่งพารามิเตอร์การค้นหาเมื่อโหลดบันทึกแล้ว ให้คลิกระเบียน
เพื่อขยายเพย์โหลด JSON แบบเต็ม คลิกอีกครั้ง เพื่อแสดงข้อความแบบเต็มหรือคุณจะพิมพ์คีย์เวิร์ดในช่องตัวกรองเพื่อจำกัดผลของบันทึกก็ได้ คลิก x
เพื่อนำตัวกรองออกและกลับไปที่ผลการดึงข้อมูลเดิม

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

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

คุณจะตรวจสอบรายละเอียดการทดสอบและดูบันทึกได้เมื่อการทดสอบเสร็จสมบูรณ์

ผู้ดูบันทึก Android Debug Bridge (adb)
หากต้องการเปิดแท็บโปรเจ็กต์ในหน้าต่างเครื่องมือบันทึก AdMob ให้คลิกคำสั่งบันทึก AdMob ในแถบเครื่องมือปลั๊กอิน Google Home (ทางด้านซ้าย) คุณสามารถเปิดแท็บบันทึก adb แยกต่างหาก สำหรับไฟล์บันทึกแต่ละไฟล์ หากต้องการลบแท็บ ให้คลิกไอคอน
ใช้ช่องเลือกเพื่อเลือกคอมโพเนนต์การบันทึกที่ต้องการเพื่อดู และเมนูแบบเลื่อนลงความรุนแรงเพื่อแสดงเฉพาะรายการที่มีความรุนแรงของบันทึกตรงกัน
สำหรับบันทึก adb ที่เลือก คุณจะกรองรายการบันทึกได้โดยใช้ช่องตัวกรองซึ่งมีตัวปรับแต่ง พิจารณาตัวพิมพ์เล็กและตัวพิมพ์ใหญ่หรือ Regex ที่ไม่บังคับ
นอกจากนี้ คุณยังสามารถทำสิ่งต่อไปนี้ได้
- ค้นหารายการที่ต้องการโดยใช้ช่อง ค้นหา และคำสั่ง ค้นหาถัดไป (ไอคอน ) และค้นหาก่อนหน้า (ไอคอน )
- ใช้คีย์ตัวปรับแต่งคำนึงถึงตัวพิมพ์เล็กและใหญ่หรือ Regex (ไม่บังคับ)
- ข้ามไปยังบรรทัด เพื่อข้ามไปยังบรรทัดที่ระบุ (ตามตัวเลข) ในบันทึก
เลือกระบุหมายเลขเพื่อดูบรรทัดบันทึกที่มีการเพิ่มหมายเลขบรรทัด เลือก Raw เพื่อดูรายการบันทึกข้อมูลดิบ

แหล่งข้อมูลและความคิดเห็น
คลิกแหล่งข้อมูลเพื่อดูรายการเครื่องมือและทรัพยากรสำหรับนักพัฒนาซอฟต์แวร์
หากต้องการส่งความคิดเห็นหรือความคิดเห็นเกี่ยวกับวิธีที่เราสามารถปรับปรุงประสบการณ์การพัฒนา Google Home Plugin ให้คลิกความคิดเห็น
