ปลั๊กอิน Google Home สําหรับ Android Studio

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

ประกาศด้านความปลอดภัย

หากไม่ต้องการให้ Android Studio จัดเก็บข้อมูลลับและรหัสผ่าน ให้ทําตามขั้นตอนต่อไปนี้

1. คลิกไฟล์ แล้วคลิกการตั้งค่า...
2. ในลักษณะที่ปรากฏและลักษณะการทำงาน ให้ขยายการตั้งค่าระบบ แล้วคลิกรหัสผ่าน
3. เลือกไม่บันทึก ลืมรหัสผ่านหลังจากรีสตาร์ท

ฟีเจอร์

เครื่องมือจำลอง 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 ให้ทำตามขั้นตอนต่อไปนี้

1. ดาวน์โหลดหรืออัปเดต Android Studio ดาวน์โหลด Android Studio
2. ไปที่ไฟล์ > การตั้งค่า (Android Studio > ค่ากำหนด ใน MacOS)
3. ในส่วนปลั๊กอิน ให้ไปที่ตลาดกลาง และค้นหา google home
4. ติดตั้งเครื่องมือและรีสตาร์ท Android Studio

หรือคุณจะดาวน์โหลดปลั๊กอินจาก JetBrains Marketplace โดยตรงก็ได้

ตั้งค่า

เมื่อติดตั้งปลั๊กอินแล้ว คุณจะต้องทำตามขั้นตอนต่อไปนี้ให้เสร็จสมบูรณ์ก่อนจึงจะใช้ Assistant Simulator และดู Cloud Logging ได้

• ลงชื่อเข้าใช้ด้วย Google
• เลือกโปรเจ็กต์ที่อยู่ในระบบคลาวด์

ลงชื่อเข้าใช้ด้วย Google

คุณลงชื่อเข้าใช้บัญชีนักพัฒนาแอปได้จากแผง Google Home โดยอนุญาตให้ Android Studio สื่อสารกับบริการของ Google ในนามของคุณ

1. คลิกแท็บ Google Home ในคอลัมน์แท็บแนวตั้งทางด้านซ้ายของหน้าต่าง Android Studio

2. ในส่วน Sign in with ให้คลิก Google เพื่อเปิดเบราว์เซอร์

   

3. เลือกบัญชีที่ลิงก์กับอุปกรณ์ในบ้านอัจฉริยะ

4. ในหน้าการให้สิทธิ์ลงชื่อเข้าใช้ด้วย Google ให้คลิกอนุญาต

5. ปิดหน้าต่างเบราว์เซอร์แล้วกลับไปที่ Android Studio

ตอนนี้คุณควรเข้าสู่ระบบแล้ว แต่จะเห็นตัวเลือกออกจากระบบ

เลือกโปรเจ็กต์ที่อยู่ในระบบคลาวด์

หลังจากลงชื่อเข้าใช้ ให้เลือกโครงการจากเมนูแบบเลื่อนลง หากต้องการกรองรายการโปรเจ็กต์ ให้พิมพ์นิพจน์ตัวกรอง เช่น matter แล้วกด Enter

เมนูแบบเลื่อนลงโปรเจ็กต์จะโหลด 100 โปรเจ็กต์แรกตามตัวกรอง ระบบจะเก็บรักษาสิ่งที่คุณเลือกไว้เมื่อออกจาก Android Studio

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

ใช้โปรแกรมจำลอง Assistant

หากต้องการเปิด Assistant Simulator ใน Android Studio ให้คลิก Utterances Panel จากแผง Google Home Plugin

การส่งการค้นหาไปยัง Assistant Simulator ทำได้หลายวิธี ต่อไป เราจะไปดูแต่ละตัวเลือก

พิมพ์คำค้นหาและรวบรวมคำตอบ

หากต้องการโต้ตอบกับ Assistant Simulator ให้พิมพ์คำค้นหาและกด Enter

คุณส่งการค้นหาอีกครั้งได้โดยคลิกไอคอนส่งอีกครั้ง cached ที่ท้ายการค้นหา

หลังจากส่งคำค้นหาอย่างน้อย 1 รายการ ให้คลิกcached เล่นซ้ำเพื่อเรียกใช้คำค้นหาอีกครั้งและตรวจสอบคำตอบของคุณ แผงถ้อยคำจะติดตามคำค้นหาและการตอบกลับของคุณในแคชที่เก็บไว้ การเล่นซ้ำจะเพิ่มคำตอบใหม่ลงในแคชภายในนี้เท่านั้น และจะไม่สร้างคำค้นหาซ้ำทุกครั้งที่คุณคลิกปุ่ม

คลิก save บันทึกเพื่อบันทึกการค้นหาและคำตอบที่คุณป้อนในแผงถ้อยคำ การโต้ตอบจะแปลงเป็น 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 ของเสียงพูด หลังจากคลิก tocรวบรวม 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 ว่ารวบรวมแล้ว

ทดสอบการพูดแบบกลุ่ม

เมื่อรวบรวมคำตอบแล้ว ให้คลิกswitch_left ทดสอบเพื่อเล่นคำค้นหาซ้ำ ตลอดจนตรวจสอบคำตอบและบันทึก เมื่อทดสอบการพูดออกเสียงแบบกลุ่ม Assistant Simulator จะคาดหวังการตอบสนองที่บันทึกไว้ในไฟล์ JSON ของคุณ หากการทดสอบแสดงผลการตอบกลับที่ยังไม่ได้รวบรวม คุณจะได้รับการแจ้งเตือนที่คล้ายกับการตอบกลับต่อไปนี้

error Expected one of: "Got it, turning on 2 lights."

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

ดู 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 หรือใช้เครื่องมือเลือกวันที่calendar_monthเพื่อเลือกวันที่แล้วป้อนเวลาในช่องข้อความ

• หากต้องการเลือกวันที่หลังจาก 5/1/22 ให้เลือกหลังและคลิกไอคอนวันที่ calendar_month
• หากต้องการเลือกวันที่ก่อนวันที่ 5/1/22 ให้เลือกก่อนและคลิกไอคอนวันที่ calendar_month
• หากต้องการเลือกวันที่ระหว่าง 5/1/22 ถึง 6/30/22 ให้เลือกก่อนและหลัง แล้วเลือกวันที่จากไอคอนวันที่ calendar_month

เลือกเรียลไทม์เพื่อดึงข้อมูลบันทึกโปรเจ็กต์ที่เผยแพร่อยู่ คลิกหยุดเพื่อสิ้นสุดฟีดแบบเรียลไทม์

ระดับความรุนแรง

หรือจะเลือกความรุนแรงระดับต่ำจากเมนูแบบเลื่อนลงก็ได้

ผลการค้นหา

คลิก cached ดึงข้อมูลเพื่อส่งพารามิเตอร์การค้นหา

เมื่อโหลดบันทึกแล้ว ให้คลิกระเบียน chevron_right เพื่อขยายเพย์โหลด JSON แบบเต็ม คลิกอีกครั้ง chevron_left เพื่อแสดงข้อความแบบเต็ม

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

ดู Home Graph และทำการทดสอบ

หากต้องการแสดงอุปกรณ์ ให้เลือก Home Graph จากแผง Google Home Plugin

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

เมื่อโหลดอุปกรณ์แล้ว ให้คลิกระเบียน chevron_right เพื่อขยายเพย์โหลด JSON แบบเต็ม

นอกจากนี้ คุณยังใช้ขยายและยุบเพื่อแสดงหรือซ่อนเพย์โหลด JSON สำหรับอุปกรณ์ได้ด้วย

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

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

ผู้ดูบันทึก Android Debug Bridge (adb)

หากต้องการเปิดแท็บโปรเจ็กต์ในหน้าต่างเครื่องมือบันทึก AdMob ให้คลิกคำสั่งบันทึก AdMob ในแถบเครื่องมือปลั๊กอิน Google Home (ทางด้านซ้าย) คุณสามารถเปิดแท็บบันทึก adb แยกต่างหาก สำหรับไฟล์บันทึกแต่ละไฟล์ หากต้องการลบแท็บ ให้คลิกไอคอน clear

ใช้ช่องเลือกเพื่อเลือกคอมโพเนนต์การบันทึกที่ต้องการเพื่อดู และเมนูแบบเลื่อนลงความรุนแรงเพื่อแสดงเฉพาะรายการที่มีความรุนแรงของบันทึกตรงกัน

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

นอกจากนี้ คุณยังสามารถทำสิ่งต่อไปนี้ได้

• ค้นหารายการที่ต้องการโดยใช้ช่อง ค้นหา และคำสั่ง ค้นหาถัดไป (ไอคอน arrow_downward) และค้นหาก่อนหน้า (ไอคอน arrow_upward)
• ใช้คีย์ตัวปรับแต่งคำนึงถึงตัวพิมพ์เล็กและใหญ่หรือ Regex (ไม่บังคับ)
• ข้ามไปยังบรรทัด เพื่อข้ามไปยังบรรทัดที่ระบุ (ตามตัวเลข) ในบันทึก

เลือกระบุหมายเลขเพื่อดูบรรทัดบันทึกที่มีการเพิ่มหมายเลขบรรทัด เลือก Raw เพื่อดูรายการบันทึกข้อมูลดิบ

แหล่งข้อมูลและความคิดเห็น

คลิกแหล่งข้อมูลเพื่อดูรายการเครื่องมือและทรัพยากรสำหรับนักพัฒนาซอฟต์แวร์

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