ยินดีต้อนรับสู่ Google Home Developer Center แหล่งใหม่เรียนรู้วิธีพัฒนาการดําเนินการในบ้านอัจฉริยะ หมายเหตุ: คุณจะสร้างการดําเนินการต่างๆ ต่อไปในคอนโซลการดําเนินการ

พลิกแอป

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

เมื่อติดตั้ง OAuth 2.0 แล้ว คุณจะเลือกกําหนดค่า App Flip ที่ใช้ OAuth ได้ ซึ่งช่วยให้ผู้ใช้ลิงก์บัญชีในระบบการตรวจสอบสิทธิ์กับบัญชี Google ได้เร็วขึ้น ส่วนต่อไปนี้อธิบายวิธีออกแบบและใช้ App Flip สําหรับการดําเนินการในบ้านอัจฉริยะ

หลักเกณฑ์การออกแบบ

ส่วนนี้จะอธิบายข้อกําหนดด้านการออกแบบและคําแนะนําสําหรับหน้าจอคํายินยอมการลิงก์บัญชี App Link หลังจากที่ Google เรียกใช้แอปแล้ว แอปจะแสดงหน้าจอขอความยินยอมต่อผู้ใช้

ข้อกำหนด

  1. คุณต้องแจ้งว่าบัญชีของผู้ใช้กําลังลิงก์กับ Google ไม่ใช่ผลิตภัณฑ์ Google ที่เจาะจง เช่น Google Home หรือ Google Assistant

คำแนะนำ

เราขอแนะนําให้คุณทําสิ่งต่อไปนี้

  1. แสดงนโยบายความเป็นส่วนตัวของ Google ใส่ลิงก์ไปยังนโยบายความเป็นส่วนตัวของ Google บนหน้าจอคํายินยอม

  2. ข้อมูลที่จะแชร์ ใช้ภาษาที่ชัดเจนและกระชับเพื่อบอกผู้ใช้ว่า Google ต้องการข้อมูลใดและเพราะเหตุใด

  3. คํากระตุ้นการตัดสินใจที่ชัดเจน ระบุคํากระตุ้นการตัดสินใจที่ชัดเจนในหน้าจอขอความยินยอม เช่น "ยอมรับและลิงก์" ทั้งนี้เนื่องจากผู้ใช้ต้องเข้าใจว่าตนเองต้องแชร์ข้อมูลใดกับ Google เพื่อลิงก์บัญชีของตน

  4. ความสามารถในการยกเลิก แสดงวิธีให้ผู้ใช้ยกเลิกหรือยกเลิกในกรณีที่ เลือกที่จะไม่ลิงก์

  5. ความสามารถในการยกเลิกการลิงก์ มีกลไกให้ผู้ใช้ยกเลิกการลิงก์ เช่น URL ไปยังการตั้งค่าบัญชีบนแพลตฟอร์ม อีกทางเลือกหนึ่งคือใส่ลิงก์ไปยังบัญชี Google ที่ผู้ใช้จะจัดการบัญชีที่ลิงก์ได้

  6. ความสามารถในการเปลี่ยนบัญชีผู้ใช้ แนะนําวิธีให้ผู้ใช้เปลี่ยนบัญชี วิธีนี้เป็นประโยชน์อย่างยิ่งหากผู้ใช้มักจะมีบัญชีหลายบัญชี

    • หากผู้ใช้ต้องปิดหน้าจอคํายินยอมเพื่อเปลี่ยนบัญชี ให้ส่งข้อผิดพลาดที่กู้คืนได้ไปให้ Google เพื่อให้ผู้ใช้ลงชื่อเข้าใช้บัญชีที่ต้องการด้วยการลิงก์ OAuth และขั้นตอนโดยนัย
  7. ใส่โลโก้ของคุณ แสดงโลโก้บริษัทในหน้าจอคํายินยอม ใช้หลักเกณฑ์สไตล์เพื่อวางโลโก้ หากต้องการแสดงโลโก้ของ Google ด้วย โปรดดูโลโก้และเครื่องหมายการค้า

รูปนี้แสดงตัวอย่างหน้าจอคํายินยอมพร้อมไฮไลต์ข้อกําหนดแต่ละรายการและคําแนะนําที่ควรปฏิบัติตามเมื่อออกแบบหน้าจอคํายินยอมของผู้ใช้
รูปที่ 1: หลักเกณฑ์การออกแบบหน้าจอคํายินยอมการลิงก์บัญชี

ตั้งค่าสําหรับ Flip ที่ใช้ OAuth

ส่วนต่อไปนี้จะอธิบายถึงข้อกําหนดเบื้องต้นสําหรับ App Flip ที่ใช้ OAuth และวิธีกําหนดค่าโปรเจ็กต์ App Flip ในคอนโซลการดําเนินการ

สร้างการดําเนินการสมาร์ทโฮมและตั้งค่าเซิร์ฟเวอร์ OAuth 2.0

คุณต้องทําสิ่งต่อไปนี้ก่อนจึงจะกําหนดค่า App Flip ได้

กําหนดค่า App Flip ในคอนโซล Actions

ส่วนต่อไปนี้อธิบายวิธีกําหนดค่า App Flip ในคอนโซล Actions

  1. กรอกข้อมูลในส่วนข้อมูลไคลเอ็นต์ OAuth ทั้งหมด (หากระบบไม่รองรับการพลิกแอป ระบบจะใช้ OAuth ทั่วไปเป็นทางเลือก)
  2. ในส่วนใช้แอปเพื่อลิงก์บัญชี(ไม่บังคับ) ให้เลือกเปิดใช้สําหรับ iOS
  3. กรอกข้อมูลในช่อง Universal Link ดูข้อมูลเพิ่มเติมเกี่ยวกับ Universal Link ได้ที่การอนุญาตให้แอปและเว็บไซต์ลิงก์ไปยังเนื้อหาของคุณ
  4. หากต้องการกําหนดค่าไคลเอ็นต์ตามต้องการ ให้เพิ่มขอบเขตแล้วคลิกเพิ่มขอบเขตในส่วนกําหนดค่าไคลเอ็นต์ (ไม่บังคับ)
  5. คลิกบันทึก

ตอนนี้คุณไปที่ส่วนถัดไปเพื่อใช้ App Flip ในแอป iOS หรือ Android ได้

ใช้ App Flip ในแอปที่มาพร้อมเครื่อง

หากต้องการใช้ App Flip คุณจําเป็นต้องแก้ไขรหัสการให้สิทธิ์ของผู้ใช้ในแอปเพื่อรับ Deep Link จาก Google

ทดสอบ App Flip ในอุปกรณ์

เมื่อสร้างการดําเนินการและกําหนดค่า App Flip ในคอนโซลและในแอปแล้ว คุณก็สามารถทดสอบ App Flip ในอุปกรณ์เคลื่อนที่ได้ คุณใช้แอป Google Assistant หรือแอป Google Home เพื่อทดสอบ App Flip ได้

หากต้องการทดสอบ App Flip จากแอป Assistant ให้ทําตามขั้นตอนต่อไปนี้

  1. ไปที่คอนโซล Actions แล้วเลือกโปรเจ็กต์
  2. คลิกทดสอบในการนําทางด้านบน
  3. เรียกใช้ขั้นตอนการลิงก์บัญชีจากแอป Assistant โดยทําดังนี้
    1. เปิด แอป Google Assistant
    2. คลิกการตั้งค่า
    3. ในแท็บ Assistant ให้คลิกระบบควบคุมอุปกรณ์ในบ้าน
    4. คลิก Add(+)
    5. เลือกการดําเนินการจากรายการผู้ให้บริการ ซึ่งจะนําหน้าด้วย "[test]" ในรายการ เมื่อคุณเลือกการดําเนินการ [ทดสอบ] จากรายการ การดําเนินการดังกล่าวควรเปิดแอปของคุณ
    6. ยืนยันว่าแอปเริ่มทํางานและเริ่มทดสอบขั้นตอนการให้สิทธิ์แล้ว

หากต้องการทดสอบ App Flip จากแอป Home ให้ทําตามขั้นตอนต่อไปนี้

  1. ไปที่คอนโซล Actions แล้วเลือกโปรเจ็กต์
  2. คลิกทดสอบในการนําทางด้านบน
  3. เรียกใช้ขั้นตอนการลิงก์บัญชีจากแอป Home โดยทําดังนี้
    1. เปิดแอป Google Home
    2. คลิกปุ่ม +
    3. คลิกตั้งค่าอุปกรณ์
    4. คลิกหากมีรายการที่ตั้งค่าไว้แล้ว
    5. เลือกการดําเนินการในบ้านอัจฉริยะจากรายการผู้ให้บริการ ซึ่งจะนําหน้าด้วย "[test]" ในรายการ เมื่อคุณเลือกการดําเนินการ [ทดสอบ] จากรายการ การดําเนินการดังกล่าวควรเปิดแอปของคุณ
    6. ยืนยันว่าแอปเริ่มทํางานและเริ่มทดสอบขั้นตอนการให้สิทธิ์แล้ว