เปิดใช้ 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 การระบุนี้จะกำหนดวิธีที่แอปโต้ตอบกับบริการ 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 ในอุปกรณ์โดยอัตโนมัติ
ต้องใช้ ARAR (ไม่บังคับ)
การใช้ฟีเจอร์ AR แอปของคุณต้องใช้ ARCore สําหรับฟังก์ชันการทํางานพื้นฐาน ARCore ช่วยเสริมฟังก์ชันการทำงานของแอป แอปของคุณทำงานได้โดยไม่ต้องใช้ ARCore
ระดับการเข้าถึง Play Store แอปของคุณจะแสดงใน Play Store เฉพาะบนอุปกรณ์ที่รองรับ ARCore เท่านั้น แอปของคุณเป็นไปตามกระบวนการแสดงข้อมูลตามปกติ
วิธีการติดตั้งบริการ Google Play สำหรับ AR Play Store จะติดตั้งบริการ Google Play สำหรับ AR ควบคู่ไปกับแอปของคุณ แอปของคุณใช้ ARSession.state เพื่อดาวน์โหลดและติดตั้ง ARCore
ข้อกำหนดของ minSdkVersion สำหรับ Android Android 7.0 (API ระดับ 24) Android 4.4 (API ระดับ 19) แม้ว่าการเรียกใช้ฟังก์ชัน AR ใดก็ตามจะต้องใช้ Android 7.0 (API ระดับ 24) เป็นอย่างน้อย
ต้องใช้ ARSession.state เพื่อตรวจสอบการรองรับ ARCore และสถานะการติดตั้ง

กำหนดให้แอปต้องใช้ 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 Optional

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

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

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

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

ทั้งแอป AR ที่จำเป็นและ AR Optional จะต้องเรียกใช้ ARSession.state ก่อนสร้างเซสชัน 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

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