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

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

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

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

  • คุณติดตั้งและเรียกใช้แอป AR Optional ในอุปกรณ์ที่ไม่รองรับ 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() เพื่อดาวน์โหลดและติดตั้ง ARCore
ข้อกำหนดของ Android minSdkVersion 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

Android

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

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

  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 แล้วเลือกแท็บที่มี ไอคอน

  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 และแอปทางเลือก AR ต้องใช้ โครูทีน ARSession.Install() ก่อนสร้างเซสชัน ARCore เพื่อตรวจสอบว่า (ยังคง) ติดตั้งบริการ Google Play สำหรับ 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 แล้ว สร้าง ARCore Session และเริ่มใช้ ARCore

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

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

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

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