Google Home Plugin for Android Studio ออกแบบและสร้างขึ้นสำหรับนักพัฒนาแพลตฟอร์ม Google Home ปลั๊กอินนี้ช่วยให้คุณเข้าถึง Google Assistant Simulator Cloud Logging และเครื่องมืออื่นๆ เพื่อลดความซับซ้อนของกระบวนการพัฒนาสมาร์ทโฮม
ประกาศด้านความปลอดภัย
หากต้องการป้องกันไม่ให้ Android Studio จัดเก็บข้อมูลลับและ รหัสผ่าน ให้ทำตามขั้นตอนต่อไปนี้
- คลิกไฟล์ แล้วคลิกการตั้งค่า...
- ในส่วนลักษณะที่ปรากฏและลักษณะการทำงาน ให้ขยายการตั้งค่าระบบ แล้วคลิก รหัสผ่าน
- เลือกไม่บันทึก ลืมรหัสผ่านหลังจากรีสตาร์ท
ฟีเจอร์
เครื่องมือจำลอง Assistant
หากต้องการทดสอบว่าอุปกรณ์สมาร์ทโฮมทำงานร่วมกับระบบนิเวศ Google Home ได้อย่างถูกต้องหรือไม่ คุณสามารถโต้ตอบกับ Assistant Simulator ได้ทุกเมื่อโดยไม่ต้อง ออกจาก Android Studio
Assistant Simulator ช่วยให้คุณ ควบคุมอุปกรณ์ได้อย่างง่ายดายโดยพิมพ์คำค้นหา เช่น "เปิดไฟ" ภายใน Android Studio, Assistant Simulator จะตอบกลับด้วยข้อความตาม คำสั่งของคุณ เช่น "ได้เลย กำลังเปิดไฟ"
ดู Cloud Logging
Google Cloud Logging ให้ข้อมูลการแก้ไขข้อบกพร่องและเมตริกที่สำคัญเพื่อให้คุณเห็นข้อมูลเชิงลึกเกี่ยวกับการใช้งาน Action เพื่อลดความซับซ้อนในการพัฒนา Google Home Plugin จะแสดง ข้อความ Cloud Logging แบบเรียลไทม์ข้างๆ โค้ดของคุณระหว่าง การแก้ปัญหา
คุณสามารถแสดงบันทึกแบบเรียลไทม์หรือเลือกช่วงวันที่ก็ได้
คำพูดแบบกลุ่ม
การตอบกลับของ Assistant Simulator ต่อคำพูดเดียวจะไม่ แน่นอน เช่น การตอบกลับอาจเป็นวลีใดวลีหนึ่งต่อไปนี้
- รับทราบ กำลังเปิดไฟ 2 ดวง
- ได้เลย กำลังเปิดไฟ 2 ดวง
- รับทราบ กำลังเปิดไฟ 2 ดวง
- ได้เลย กำลังเปิดไฟ 2 ดวง
หากต้องการเรียกใช้การทดสอบอัตโนมัติและยืนยันว่าการผสานรวมกับ Google ทำงานอย่างไรกับ การตอบกลับต่างๆ เหล่านี้ คุณสามารถส่งคำพูดแบบกลุ่มไปยัง Assistant Simulatorได้โดยเรียกใช้สคริปต์คำพูด เมื่อบันทึกสคริปต์แล้ว คุณจะรวบรวมการตอบกลับและเรียกใช้การทดสอบหลายรายการเทียบกับคำค้นหาได้
เครื่องมือดูกราฟ Home
เครื่องมือดูกราฟ Home ช่วยให้คุณ แสดงสถานะของอุปกรณ์และเปิดตัว Google Home Test Suite ในเบราว์เซอร์ได้
เครื่องมือดูบันทึก Android Debug Bridge (adb)
Adb Log Viewer เป็นเครื่องมือสำหรับดูและวิเคราะห์ไฟล์บันทึก เช่น Matter บันทึกของอุปกรณ์, บันทึก Google Home และบันทึก Android
ติดตั้ง
หากต้องการติดตั้ง Google Home Plugin ใน Android Studio, ให้ทำตามขั้นตอนต่อไปนี้
- ดาวน์โหลดหรืออัปเดต Android Studio ดาวน์โหลด Android Studio
- ไปที่ไฟล์ > การตั้งค่า (Android Studio > ค่ากำหนด ใน MacOS)
- ในส่วนปลั๊กอิน ให้ไปที่ Marketplace แล้วค้นหา
google home - ติดตั้งเครื่องมือแล้วรีสตาร์ท Android Studio
นอกจากนี้ คุณยังดาวน์โหลดปลั๊กอินได้โดยตรงจาก JetBrains Marketplace
ตั้งค่า
เมื่อติดตั้งปลั๊กอินแล้ว คุณจะต้องทำตามขั้นตอนต่อไปนี้ให้เสร็จสมบูรณ์ก่อนจึงจะใช้ Assistant Simulator และ ดู Cloud Logging ได้
ลงชื่อเข้าใช้ด้วย Google
คุณสามารถลงชื่อเข้าใช้บัญชีนักพัฒนาแอปจากแผงควบคุมสมาร์ทโฮมของ Google Home, เพื่อให้สิทธิ์ Android Studio ในการสื่อสารกับบริการของ Google ในนามของคุณ
คลิกแท็บ Google Home ในคอลัมน์แท็บแนวตั้งทางด้านซ้าย ของหน้าต่าง Android Studio
ในส่วนลงชื่อเข้าใช้ด้วย ให้คลิก Google เพื่อเปิดเบราว์เซอร์
เลือกบัญชีที่ลิงก์กับอุปกรณ์สมาร์ทโฮม
ในหน้าการให้สิทธิ์ลงชื่อเข้าใช้ด้วย Google ให้คลิกอนุญาต
ปิดหน้าต่างเบราว์เซอร์แล้วกลับไปที่ Android Studio
ตอนนี้คุณควรจะเข้าสู่ระบบแล้ว โดยมีตัวเลือกออกจากระบบ
เลือกโปรเจ็กต์ที่อยู่ในระบบคลาวด์
หลังจากลงชื่อเข้าใช้แล้ว ให้เลือกโปรเจ็กต์ จากเมนูแบบเลื่อนลง หากต้องการกรองรายการโปรเจ็กต์ ให้พิมพ์นิพจน์ตัวกรอง เช่น matter แล้วกด Enter
เมนูแบบเลื่อนลงโปรเจ็กต์ จะโหลดโปรเจ็กต์ 100 รายการแรกตามตัวกรอง ของคุณ ระบบจะเก็บตัวเลือกของคุณไว้เมื่อคุณออกจาก Android Studio
หากต้องการความช่วยเหลือเกี่ยวกับตัวกรองโปรเจ็กต์ โปรดดู พารามิเตอร์การค้นหา ในข้อมูลอ้างอิงของ Google Cloud
ใช้เครื่องมือจำลอง Assistant
หากต้องการเปิด Assistant Simulator ใน Android Studio, ให้คลิก แผงคำพูด จากแผง 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 ให้คลิก ไฟล์คำพูด เพื่อเปิด
ไฟล์ JSON ที่บันทึกไว้ในแท็บใหม่ สำหรับเลือกเส้นทาง คุณสามารถเลือก
ไฟล์หรือโฟลเดอร์ก็ได้ หากเลือกโฟลเดอร์ รวบรวม และทดสอบ จะทำงานกับไฟล์คำพูด .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 จะเรียกใช้คำค้นหาแต่ละรายการและแสดงการตอบกลับ เครื่องหมายถูก check จะแสดงใน แถบสถานะ หากการทดสอบสำเร็จ
ดู Cloud Logging
หากต้องการเปิดแท็บโปรเจ็กต์ในหน้าต่างเครื่องมือ Cloud Logs ให้คลิก Cloud Logs จากแผง Google Home Plugin คุณสามารถเปิดแท็บ Cloud Log แยกกันสำหรับแต่ละโปรเจ็กต์ได้
คำค้นหา
สำหรับโปรเจ็กต์ที่เลือก คุณยังกรองบันทึกได้โดยใช้ช่องคำค้นหา
เช่น หากต้องการกรองบันทึกสำหรับคีย์เวิร์ด light ให้ทำดังนี้
เลือกใช้ QL เพื่อใช้ ภาษาการค้นหา Logging
ต่อไปนี้เป็นตัวอย่างคำค้นหา 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 และเรียกใช้การทดสอบ
หากต้องการแสดงรายการอุปกรณ์ ให้เลือก Home Graph จากแผง Google Home Plugin
คลิก รีเฟรช ที่แคชไว้เพื่อแสดง ชื่ออุปกรณ์ รหัสอุปกรณ์ และ ประเภทอุปกรณ์ สำหรับอุปกรณ์ที่เชื่อมโยงกับโปรเจ็กต์ที่เลือก คุณสามารถเปิดแผง Google Home Graphหลายแผงสำหรับโปรเจ็กต์แยกกันได้
เมื่อโหลดอุปกรณ์แล้ว ให้คลิกบันทึกใดก็ได้ เพื่อขยายเพย์โหลด JSON แบบเต็ม
นอกจากนี้ คุณยังใช้ขยาย และยุบ เพื่อแสดงและซ่อนเพย์โหลด JSON สำหรับอุปกรณ์ได้ด้วย
หากต้องการเปิดตัว Test Suite สำหรับอุปกรณ์ที่เฉพาะเจาะจง ให้คลิก ทดสอบ ซึ่งจะเปิดตัว Test Suite ในเบราว์เซอร์โดยเลือกอุปกรณ์ของคุณและพร้อมสำหรับการทดสอบ คลิกเริ่ม แล้วรอผลการทดสอบ
คุณสามารถตรวจสอบรายละเอียดการทดสอบและดูบันทึกเมื่อการทดสอบเสร็จสมบูรณ์
เครื่องมือดูบันทึก Android Debug Bridge (adb)
หากต้องการเปิดแท็บโปรเจ็กต์ในหน้าต่างเครื่องมือ Adb Log ให้คลิกคำสั่ง Adb Log ในแถบเครื่องมือปลั๊กอิน Google Home (ทางด้านซ้าย) คุณสามารถเปิดแท็บ Adb Log แยกกันสำหรับไฟล์บันทึกแต่ละไฟล์ได้ หากต้องการลบแท็บ ให้คลิกไอคอน
ใช้ช่องเลือก เพื่อเลือกคอมโพเนนต์การบันทึกที่เฉพาะเจาะจงที่จะดู และใช้เมนูแบบเลื่อนลงความรุนแรง เพื่อแสดงเฉพาะรายการที่มีความรุนแรงของบันทึกที่ตรงกัน
สำหรับบันทึก adb ที่เลือก คุณสามารถกรองรายการบันทึกได้โดยใช้ช่องตัวกรอง พร้อมตัวแก้ไขคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ หรือRegex ที่ไม่บังคับ
นอกจากนี้ คุณยังทำสิ่งต่อไปนี้ได้
- ค้นหารายการที่เฉพาะเจาะจงโดยใช้ช่องค้นหา และคำสั่งค้นหาถัดไป ( ไอคอน) และค้นหาก่อนหน้า ( ไอคอน)
- ใช้ตัวแก้ไขคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ หรือRegex ที่ไม่บังคับ
- ข้ามไปยังบรรทัด เพื่อข้ามไปยังบรรทัดที่ระบุ (ตามหมายเลข) ในบันทึก
เลือกมีหมายเลข เพื่อดูบรรทัดบันทึกที่มีหมายเลขบรรทัดเพิ่มเข้ามา เลือกดิบ เพื่อดูรายการบันทึกดิบ
แหล่งข้อมูลและความคิดเห็น
คลิกแหล่งข้อมูล เพื่อดูรายการเครื่องมือและแหล่งข้อมูลสำหรับนักพัฒนาแอป
หากต้องการส่งความคิดเห็นหรือข้อเสนอแนะเกี่ยวกับวิธีที่เราสามารถปรับปรุงประสบการณ์การพัฒนา ด้วย Google Home Plugin ให้คลิก ความคิดเห็น
