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

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

กำหนดค่าแอปเป็น "ต้องใช้ AR" หรือ "ไม่บังคับให้ใช้ AR"

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

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

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

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

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

ทำให้แอปต้องใช้ AR

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 ไม่บังคับ

Android

  1. นำทางไปยัง Edit > Project Settings > XR Plug-in Management > ARCore

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

  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"

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

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

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

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

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

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

  • รองรับ 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 ได้ด้วย

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

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

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