เปิดใช้ AR ในแอป AR Foundation (Android เท่านั้น)

เปิดใช้ AR เพื่อใช้ฟีเจอร์ Augmented Reality ในแอปใหม่หรือแอปที่มีอยู่

กำหนดค่าแอปให้เป็น AR Required หรือ AR Optional

ระบบจะจัดเก็บฟีเจอร์ AR ทั้งหมดไว้ในแอปที่ชื่อว่า บริการ Google Play สำหรับ AR ซึ่ง Play Store จะอัปเดตแยกต่างหาก เพื่อประหยัดพื้นที่ในอุปกรณ์แต่ละเครื่อง แอป Android ที่ใช้ฟีเจอร์ AR จะสื่อสารกับบริการ Google Play สำหรับ AR โดยใช้ ARCore SDK คุณกำหนดค่าแอปที่รองรับฟีเจอร์ AR ได้ 2 วิธี ได้แก่ AR Required และ AR Optional การกำหนดนี้จะเป็นตัวกำหนดวิธีที่แอป AR โต้ตอบกับแอปบริการ Google Play สำหรับ AR

แอป AR Required จะทำงานไม่ได้หากไม่มี ARCore แอปนี้ต้องใช้อุปกรณ์ที่รองรับ ARCore ซึ่งติดตั้งบริการ Google Play สำหรับ AR

  • Google Play Store จะแสดงแอป AR Required ในอุปกรณ์ที่รองรับ ARCore เท่านั้น
  • เมื่อผู้ใช้ติดตั้งแอป AR Required Google Play Store จะติดตั้งบริการ Google Play สำหรับ AR ในอุปกรณ์ของผู้ใช้โดยอัตโนมัติ อย่างไรก็ตาม แอปของคุณยังคงต้องทำการตรวจสอบรันไทม์เพิ่มเติมในกรณีที่บริการ Google Play สำหรับ AR ล้าสมัยหรือถูกถอนการติดตั้งด้วยตนเอง

แอป AR Optional จะใช้ ARCore เพื่อเพิ่มประสิทธิภาพการทำงานที่มีอยู่ แอปนี้มีฟีเจอร์ AR ที่เลือกได้ ซึ่งจะเปิดใช้งานในอุปกรณ์ที่รองรับ ARCore และติดตั้งบริการ Google Play สำหรับ AR แล้วเท่านั้น

  • แอป AR Optional สามารถติดตั้งและทำงานในอุปกรณ์ที่ไม่รองรับ ARCore ได้
  • เมื่อผู้ใช้ติดตั้งแอป AR Optional Google Play Store จะไม่ ติดตั้งบริการ Google Play สำหรับ AR ในอุปกรณ์โดยอัตโนมัติ
AR RequiredAR Optional
การใช้ฟีเจอร์ AR แอปของคุณต้องใช้ ARCore สำหรับฟังก์ชันการทำงานพื้นฐาน ARCore จะเพิ่มฟังก์ชันการทำงานของแอป แอปของคุณสามารถทำงานได้โดยไม่ต้องรองรับ ARCore
การแสดงใน Play Store แอปของคุณจะแสดงใน Play Store เฉพาะในอุปกรณ์ที่รองรับ ARCore แอปของคุณเป็นไปตามขั้นตอนการแสดงปกติ
วิธีการติดตั้งบริการ Google Play สำหรับ AR Play Store จะติดตั้งบริการ Google Play สำหรับ AR พร้อมกับแอปของคุณ แอปของคุณใช้ โคโรทีน ARSession.Install() เพื่อดาวน์โหลดและติดตั้ง ARCore
ข้อกำหนด minSdkVersion ของ Android Android 7.0 (API ระดับ 24) Android 4.4 (API ระดับ 19) แม้ว่า การเรียกใช้ ฟังก์ชันการทำงาน AR ใดๆ จะต้องใช้ Android 7.0 (API ระดับ 24) เป็นอย่างน้อย
ต้องใช้ ARSession.state เพื่อตรวจสอบการรองรับ ARCore และสถานะการติดตั้ง
ต้องใช้ โคโรทีน ARSession.Install() เพื่อติดตั้งบริการ Google Play สำหรับ AR

ทำให้แอปเป็น AR Required

Android

  1. ไปที่Edit > Project Settings > XR Plug-in Management > ARCore Requirement ถูกตั้งค่าเป็น Required โดยค่าเริ่มต้น

  2. คลิก Edit > Project Settings > Player แล้วเลือกแท็บที่มีไอคอน Android

  3. ในส่วนOther Settings > Identification ให้ระบุ Minimum API Level เป็น 24 ขึ้นไป

iOS

  1. ไปที่Edit > Project Settings > XR Plug-in Management > ARKit Requirement ถูกตั้งค่าเป็น Required โดยค่าเริ่มต้น

  2. คลิกEdit > Project Settings > Player แล้วเลือกแท็บที่มีไอคอน iOS

  3. ในส่วนOther Settings > Configuration ให้ระบุ Target minimum iOS Version สำหรับแอป

ทำให้แอปเป็น AR Optional

Android

  1. ไปที่Edit > Project Settings > XR Plug-in Management > ARCore

  2. จากเมนูแบบเลื่อนลงRequirement ให้เลือกOptional เพื่อตั้งค่าแอปเป็น AR Optional

  3. คลิก Edit > Project Settings > Player แล้วเลือกแท็บที่มีไอคอน Android

  4. ในส่วนOther Settings > Identification ให้ระบุ Minimum API Level เป็น 24 ขึ้นไป

iOS

  1. ไปที่Edit > Project Settings > XR Plug-in Management > ARKit

  2. จากเมนูแบบเลื่อนลงRequirement ให้เลือกOptional เพื่อตั้งค่าแอปเป็น AR Optional

  3. คลิกEdit > Project Settings > Player แล้วเลือกแท็บที่มีไอคอน iOS

  4. ในส่วนOther Settings > Configuration ให้ระบุ Target minimum iOS Version สำหรับแอป

ทำการตรวจสอบรันไทม์

ตรวจสอบว่าติดตั้งบริการ Google Play สำหรับ AR แล้ว

ทั้งแอป AR Required และ AR Optional ต้องใช้ โคโรทีน ARSession.Install() ก่อนที่จะสร้างเซสชัน ARCore เพื่อตรวจสอบว่ามีการติดตั้งบริการ Google Play สำหรับ AR เวอร์ชันที่เข้ากันได้ (ยังคง) อยู่หรือไม่ และเพื่อให้แน่ใจว่าได้ดาวน์โหลดข้อมูลโปรไฟล์อุปกรณ์ ARCore ที่จำเป็นทั้งหมดแล้ว

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

  • รองรับ ARCore
  • ติดตั้ง Google Play Services for AR แล้ว หากไม่ได้ติดตั้ง (อาจเป็นเพราะผู้ใช้ได้นำออก) หรือเวอร์ชันเก่าเกินไป แอป จะแจ้งให้ผู้ใช้ติดตั้งหรืออัปเดต
  • มีข้อมูลโปรไฟล์อุปกรณ์ ARCore ที่เป็นปัจจุบัน หากข้อมูลล้าสมัย แอปจะดาวน์โหลดข้อมูลใหม่

ตั้งค่า ARSession.attemptUpdate เป็น false เพื่อปิดใช้การตรวจสอบเริ่มต้นเหล่านี้ แอปของคุณควรจัดการกับเงื่อนไขต่อไปนี้

เงื่อนไข การดำเนินการ
อุปกรณ์ไม่รองรับ ARCore ซ่อนฟังก์ชันการทำงานที่เกี่ยวข้องกับ AR
อุปกรณ์รองรับ ARCore แต่ไม่ได้ติดตั้ง Google Play Services for AR และ/หรือ ข้อมูลโปรไฟล์อุปกรณ์ ARCore หรือข้อมูลล้าสมัย แจ้งให้ผู้ใช้ติดตั้งหรืออัปเดต Google Play Services for AR และ/หรือข้อมูลโปรไฟล์อุปกรณ์ ARCore โดยเรียกใช้ ARSession.Install()
อุปกรณ์รองรับ ARCore และ Google Play Services for AR และ มีการติดตั้งข้อมูลโปรไฟล์อุปกรณ์ ARCore แล้ว รวมถึงเป็นเวอร์ชันล่าสุด สร้าง Session ของ ARCore และเริ่มใช้ ARCore

นอกจากนี้ คุณยังตรวจสอบ ARSession.state สำหรับสถานะการติดตั้งและการรองรับได้ด้วย

ปฏิบัติตามข้อกำหนดด้านความเป็นส่วนตัวของผู้ใช้

ตรวจสอบว่าแอปของคุณเป็นไปตามข้อกำหนดด้านความเป็นส่วนตัวของผู้ใช้ของ ARCore ก่อนเผยแพร่แอปใน Play Store

สิ่งที่จะเกิดขึ้นหลังจากนี้