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

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

Matter ; Home APIs

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

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

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

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

ฟีเจอร์

เครื่องมือจำลอง Assistant

หากต้องการทดสอบว่าอุปกรณ์สมาร์ทโฮมทำงานร่วมกับระบบนิเวศของ Google Home ได้อย่างถูกต้องหรือไม่ คุณสามารถโต้ตอบกับ Assistant Simulator ได้ทุกเมื่อโดยไม่ต้องออกจาก Android Studio

Assistant Simulator ช่วยให้คุณควบคุมอุปกรณ์ได้อย่างง่ายดายด้วยการพิมพ์ข้อความค้นหา เช่น "เปิดไฟ" Android Studio จะตอบกลับด้วย SMS ตามคำสั่งของคุณ เช่น "ได้เลย ฉันจะเปิดไฟ"Assistant Simulator

ดู Cloud Logging

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

คุณสามารถแสดงบันทึกแบบเรียลไทม์หรือเลือกช่วงวันที่ได้

วลีแบบเป็นกลุ่ม

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

• เข้าใจแล้ว กำลังเปิดไฟ 2 ดวง
• ได้เลย กำลังเปิดไฟ 2 ดวง
• เข้าใจแล้ว กำลังเปิดไฟ 2 ดวง
• กำลังเปิดไฟ 2 ดวง

หากต้องการเรียกใช้การทดสอบอัตโนมัติและยืนยันวิธีที่การผสานรวม Google ทำงานร่วมกับคำตอบต่างๆ เหล่านี้ คุณสามารถส่งคําพูดเป็นกลุ่มไปยัง Assistant Simulator ได้โดยเรียกใช้สคริปต์คําพูด เมื่อบันทึกสคริปต์แล้ว คุณจะรวบรวมคำตอบและทำการทดสอบหลายรายการกับคำค้นหาได้

ผู้ดูกราฟของ Home

เครื่องมือดู Home Graph ช่วยให้คุณแสดงสถานะของอุปกรณ์และเปิดชุดทดสอบ Google Home ในเบราว์เซอร์ได้

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

Adb Log Viewer เป็นเครื่องมือสำหรับดูและวิเคราะห์ไฟล์บันทึก เช่น Matterไฟล์บันทึกของอุปกรณ์ บันทึกของ Google Home และบันทึกของ Android

ติดตั้ง

หากต้องการติดตั้ง Google Home Plugin ใน Android Studio ให้ทำตามขั้นตอนต่อไปนี้

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

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

ตั้งค่า

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

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

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

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

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

2. สำหรับลงชื่อเข้าใช้ด้วย ให้คลิก Google เพื่อเปิดเบราว์เซอร์

   

3. เลือกบัญชีที่ลิงก์กับอุปกรณ์สมาร์ทโฮม

4. คลิกอนุญาตในหน้าการให้สิทธิ์ Sign in with Google

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

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

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

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

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

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

ใช้เครื่องจำลอง Assistant

หากต้องการเปิด Assistant Simulator ใน Android Studio ให้คลิกแผงคำพูดจากแผง 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 ให้คลิกไฟล์คำพูดเพื่อเปิดไฟล์ JSON ที่บันทึกไว้ในแท็บใหม่ ในส่วนเลือกเส้นทาง คุณจะเลือกไฟล์หรือโฟลเดอร์ได้ หากเลือกโฟลเดอร์ ตัวเลือกรวบรวมและทดสอบจะทำงานกับไฟล์ .json ทั้งหมดของคำพูดในโฟลเดอร์นั้น

คุณสามารถเปิดแท็บหลายแท็บสำหรับไฟล์เดียวกันหรือไฟล์ที่แตกต่างกันได้ เช่น lights, lights(1) และ plug

แถบสถานะจะแสดงผลการทดสอบครั้งล่าสุด (หากมี) จุดสีเหลืองหรือสีเขียวเพื่อระบุว่ามีการรวบรวมไฟล์หรือไม่ และเส้นทางไฟล์ของคําพูด .json หลังจากคลิก tocCollect แล้ว 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

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

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

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

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

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

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

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

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

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

เลือกเรียงลำดับเพื่อดูบรรทัดบันทึกที่มีการเพิ่มหมายเลขบรรทัด เลือกดิบเพื่อดูรายการบันทึกดิบ

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

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

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