ตัวอย่างแอป Android สำหรับ Home API

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

แอปตัวอย่างแสดงความสามารถพื้นฐานของ Google Home API สําหรับ Android

ข้อกำหนดเบื้องต้น

หากต้องการสร้าง ติดตั้ง และทดสอบแอป คุณจะต้องมีคุณสมบัติตามข้อกําหนดเบื้องต้นต่อไปนี้

• Android Studio เวอร์ชัน 2024.2.1 ("Ladybug") ขึ้นไป โปรดทราบว่าเวอร์ชันที่เก่ากว่านี้อาจใช้งานกับ Home APIs SDK อย่างไม่ถูกต้อง

  ดาวน์โหลด Android Studio

• โปรแกรมแก้ไขข้อบกพร่อง Android (adb)

  ติดตั้ง adb

  ซึ่งทําได้โดยใช้ SDK Manager

และหากต้องการทดสอบ Home API คุณจะต้องมีสิ่งต่อไปนี้

• อุปกรณ์ Android ที่ใช้ Android 10 ขึ้นไปซึ่งตั้งค่าด้วยบัญชี Google ที่คุณตั้งใจจะใช้สำหรับการพัฒนา ตรวจสอบว่าได้ติดตั้ง Android Studio เวอร์ชันล่าสุดและลงชื่อเข้าใช้ด้วยบัญชีสำหรับนักพัฒนาซอฟต์แวร์นี้แล้ว
• เครือข่าย Wi-Fi
• หากต้องการเข้าถึงและควบคุมอุปกรณ์ Matter คุณต้องมีสมาร์ทโฮมฮับของ Google ที่รองรับ Home API ด้วย ดูรายละเอียดได้ที่การเชื่อมต่อใน Android

• อุปกรณ์ที่รองรับอย่างน้อย 1 เครื่องในบ้าน หากอุปกรณ์นี้ (หรืออุปกรณ์อื่นๆ ที่ต้องการทดสอบ) ใช้ Thread ฮับต้องเป็น Thread Border Router ด้วย แอปตัวอย่าง Android รองรับประเภทและลักษณะของอุปกรณ์ต่อไปนี้

  • ไฟอุณหภูมิสี (เปิดและปิด ความสว่าง)
  • เซ็นเซอร์ตรวจจับสัญญาณ (สถานะบูลีน)
  • หลอดไฟหรี่แสงได้ (เปิดและปิด ความสว่าง)
  • ไฟสีแบบขยาย (เปิดและปิด ความสว่าง)
  • สวิตช์ทั่วไป
  • เซ็นเซอร์ตรวจจับการมีคนอยู่ (การตรวจจับว่ามีคนอยู่ในบ้าน)
  • เปิด/ปิดไฟ (เปิดและปิด ความสว่าง)
  • สวิตช์เปิด/ปิดไฟ
  • เปิด/ปิดอุปกรณ์แบบเสียบปลั๊ก (เปิดและปิด)
  • เซ็นเซอร์เปิด/ปิด

ดาวน์โหลดซอร์สโค้ด

ซอร์สโค้ดของแอปตัวอย่างมีอยู่ใน GitHub

ไปยังตำแหน่งที่ต้องการบันทึกโปรเจ็กต์ แล้วทําการโคลนดังนี้

git clone https://github.com/google-home/google-home-api-sample-app-android.git

ตั้งค่า SDK

Home API สำหรับ Android ในรุ่นเบต้าแบบเปิดนี้ยังไม่เป็นส่วนหนึ่งของไลบรารีมาตรฐานที่ Google ให้บริการสำหรับการพัฒนา หากต้องการพัฒนาแอปพลิเคชัน Android ด้วย Home API คุณต้องดาวน์โหลดและโฮสต์ไลบรารีในเครื่อง

หากต้องการดาวน์โหลด Home APIs Android SDK คุณต้องลงชื่อเข้าใช้ Google Home Developers ก่อน

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

สร้างแอป

1. เปิด Android Studio แล้วเปิดโฟลเดอร์โปรเจ็กต์ google-home-api-sample-app-android ที่โคลนไปยังเครื่อง

2. ในระหว่างการตั้งค่าครั้งแรก Android Studio อาจใช้เวลาถึง 10 นาทีในการดาวน์โหลดไลบรารีทั้งหมดของโปรเจ็กต์และสร้าง Gradle ให้เสร็จสมบูรณ์

3. เชื่อมต่อคอมพิวเตอร์กับโทรศัพท์ Android จริงผ่านสาย USB และเปิดใช้ ADB ในตัวเลือกสำหรับนักพัฒนาแอป ตรวจสอบว่า Android Studio เชื่อมต่อกับโทรศัพท์ Android ได้ผ่าน ADB

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

   1. เปิดโปรเจ็กต์
   2. ขยายลําดับชั้นแหล่งที่มา
   3. เลือกส่วนในแพ็กเกจที่ต้องการเปลี่ยน หรือพูดอีกอย่างคือ com.example
   4. คลิกขวาที่แพ็กเกจ แล้วเลือกปรับโครงสร้าง > เปลี่ยนชื่อ...
   5. ป้อนชื่อใหม่แล้วคลิกปรับโครงสร้าง
   6. แก้ไขไฟล์ build.gradle.kts โดยเปลี่ยน android namespace และ applicationId เป็นชื่อแพ็กเกจใหม่

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

สร้างใบรับรองการรับรอง

เมื่อคุณเรียกใช้หรือแก้ไขข้อบกพร่องของแอปใน Android Studio ระบบจะสร้างใบรับรองการแก้ไขข้อบกพร่องโดยอัตโนมัติเพื่อการพัฒนาและการแก้ไขข้อบกพร่อง ดูคำอธิบายฉบับเต็มได้ที่หัวข้อAndroid Studio: ลงชื่อบิลด์แก้ไขข้อบกพร่อง

1. สร้างใบรับรอง App Signing สำหรับการแก้ไขข้อบกพร่องโดยเรียกใช้แอปใน Android Studio เมื่อคุณเรียกใช้หรือแก้ไขข้อบกพร่องของแอปใน Android Studio Android Studio จะสร้างใบรับรองการรับรองแอปโดยอัตโนมัติเพื่อการพัฒนาและการแก้ไขข้อบกพร่อง ดูคำอธิบายทั้งหมดได้ที่ Android Studio: ลงนามในบิลด์แก้ไขข้อบกพร่อง

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

   ดูวิธีการโดยละเอียดได้ที่เรียกใช้แอปในอุปกรณ์ฮาร์ดแวร์ในเว็บไซต์ของนักพัฒนาแอป Android

   จากนั้นให้หยุดแอปที่ทำงานอยู่

2. รับลายนิ้วมือ SHA-1 ของใบรับรองการแก้ไขข้อบกพร่องโดยทําตามวิธีการที่ระบุไว้อย่างละเอียดในหัวข้อจัดการไคลเอ็นต์ OAuth / ประเภทแอปพลิเคชัน / แอปพลิเคชันเนทีฟ / Android ในเว็บไซต์ความช่วยเหลือของ Google Cloud Console

ตั้งค่าความยินยอม OAuth

1. ในคอนโซล Google Cloud ให้ไปที่แดชบอร์ดเครื่องมือเลือกโปรเจ็กต์ แล้วเลือกโปรเจ็กต์ที่ต้องการใช้สร้างข้อมูลเข้าสู่ระบบ OAuth
2. ไปที่หน้า API และบริการ แล้วคลิกข้อมูลเข้าสู่ระบบในเมนูการนำทาง

3. หากยังไม่ได้กําหนดค่าหน้าจอขอความยินยอมสําหรับโปรเจ็กต์ Google Cloud นี้ ปุ่มกําหนดค่าหน้าจอขอความยินยอมจะปรากฏขึ้น ในกรณีนี้ ให้กําหนดค่าหน้าจอความยินยอมโดยใช้ขั้นตอนต่อไปนี้ หรือหากไม่ ให้ไปที่ส่วนถัดไป

   1. คลิกกําหนดค่าหน้าจอความยินยอม หน้าหน้าจอขอความยินยอม OAuth จะปรากฏขึ้น
   2. เลือกภายในหรือภายนอก โดยขึ้นอยู่กับกรณีการใช้งาน แล้วคลิกสร้าง แผงหน้าจอขอความยินยอม OAuth จะปรากฏขึ้น
   3. ป้อนข้อมูลในหน้าข้อมูลแอปตามวิธีการบนหน้าจอ แล้วคลิกบันทึกและดำเนินการต่อ แผงขอบเขตจะปรากฏขึ้น
   4. คุณไม่จําเป็นต้องเพิ่มขอบเขตใดๆ เพียงคลิกบันทึกและดําเนินการต่อ แผงผู้ใช้ทดสอบจะปรากฏขึ้น
   5. คลิกกลุ่มเป้าหมาย แล้วคลิกปุ่ม + เพิ่มผู้ใช้
   6. ป้อนอีเมลของผู้ใช้ทดสอบ แล้วคลิกปุ่มบันทึก
   7. คลิกบันทึกและต่อไป แผงสรุปจะปรากฏขึ้น
   8. ตรวจสอบข้อมูลหน้าจอขอความยินยอม OAuth แล้วคลิกกลับไปยังแดชบอร์ด

ดูรายละเอียดทั้งหมดได้ที่การตั้งค่าหน้าจอขอความยินยอม OAuth ในเว็บไซต์ความช่วยเหลือของ Google Cloud Console อย่าลืมเพิ่มผู้ใช้ทดสอบอย่างน้อย 1 รายก่อนดำเนินการต่อ

ตั้งค่าข้อมูลเข้าสู่ระบบ OAuth

1. ลงทะเบียนแอปตัวอย่างสําหรับ OAuth 2.0 และสร้างข้อมูลเข้าสู่ระบบ OAuth โดยทําตามวิธีการที่ระบุไว้ในการตั้งค่า OAuth 2.0
   1. ระบุประเภทแอปพลิเคชัน ซึ่งก็คือแอปเนทีฟ/Android
   2. เพิ่มลายนิ้วมือ SHA-1 ลงในไคลเอ็นต์ OAuth โดยทําตามวิธีการในหัวข้อการตั้งค่า OAuth 2.0 / แอปพลิเคชันเนทีฟ / Android ในเว็บไซต์ความช่วยเหลือของ Google Cloud Console คุณควรสร้างคีย์ SHA-1 จากคีย์เริ่มต้นของ Android Studio ตลอดกระบวนการพัฒนา

เรียกใช้แอป

1. เมื่ออุปกรณ์เคลื่อนที่เชื่อมต่อกับเครื่องในเครื่องแล้ว ให้คลิกเรียกใช้โปรเจ็กต์อีกครั้งเพื่อเรียกใช้แอปตัวอย่างบนอุปกรณ์เคลื่อนที่

เมื่อติดตั้งแล้ว แอปจะพร้อมใช้งานบนอุปกรณ์เคลื่อนที่เป็นตัวอย่างแอป Home API