กำหนดค่าเซสชัน ARCore เพื่อสร้างประสบการณ์ AR สำหรับแอป
เซสชันคืออะไร
กระบวนการของ AR ทั้งหมด เช่น การติดตามการเคลื่อนไหว ความเข้าใจด้านสิ่งแวดล้อม และการประมาณแสง เกิดขึ้นในเซสชัน ARCore Session
คือจุดแรกเข้าของ ARCore API โดยจะจัดการสถานะระบบ AR และจัดการวงจรเซสชัน ซึ่งจะช่วยให้แอปสร้าง กำหนดค่า เริ่ม หรือหยุดเซสชันได้ สิ่งสำคัญที่สุดคือ ช่วยให้แอปรับเฟรมที่อนุญาตการเข้าถึงรูปภาพกล้องและท่าทางของอุปกรณ์
เซสชันสามารถใช้เพื่อกำหนดค่าฟีเจอร์ต่อไปนี้ได้
- การประมาณแสงสว่าง
- แท็ก Anchor
- รูปภาพเสริม
- Augmented Faces
- Depth API
- ตำแหน่งทันใจ
- ARCore Geospatial API
ยืนยันว่าติดตั้ง ARCore และเป็นเวอร์ชันล่าสุดแล้ว
ก่อนสร้าง Session
โปรดยืนยันว่าได้ติดตั้ง ARCore และเป็นเวอร์ชันล่าสุดแล้ว หากไม่ได้ติดตั้ง ARCore ไว้ การสร้างเซสชันจะไม่สำเร็จและการติดตั้งหรืออัปเกรด ARCore ที่ตามมาต้องรีสตาร์ทแอป
Java
// Verify that ARCore is installed and using the current version.
private boolean isARCoreSupportedAndUpToDate() {
ArCoreApk.Availability availability = ArCoreApk.getInstance().checkAvailability(this);
switch (availability) {
case SUPPORTED_INSTALLED:
return true;
case SUPPORTED_APK_TOO_OLD:
case SUPPORTED_NOT_INSTALLED:
try {
// Request ARCore installation or update if needed.
ArCoreApk.InstallStatus installStatus = ArCoreApk.getInstance().requestInstall(this, true);
switch (installStatus) {
case INSTALL_REQUESTED:
Log.i(TAG, "ARCore installation requested.");
return false;
case INSTALLED:
return true;
}
} catch (UnavailableException e) {
Log.e(TAG, "ARCore not installed", e);
}
return false;
case UNSUPPORTED_DEVICE_NOT_CAPABLE:
// This device is not supported for AR.
return false;
case UNKNOWN_CHECKING:
// ARCore is checking the availability with a remote query.
// This function should be called again after waiting 200 ms to determine the query result.
case UNKNOWN_ERROR:
case UNKNOWN_TIMED_OUT:
// There was an error checking for AR availability. This may be due to the device being offline.
// Handle the error appropriately.
}
}
Kotlin
// Verify that ARCore is installed and using the current version.
fun isARCoreSupportedAndUpToDate(): Boolean {
return when (ArCoreApk.getInstance().checkAvailability(this)) {
Availability.SUPPORTED_INSTALLED -> true
Availability.SUPPORTED_APK_TOO_OLD, Availability.SUPPORTED_NOT_INSTALLED -> {
try {
// Request ARCore installation or update if needed.
when (ArCoreApk.getInstance().requestInstall(this, true)) {
InstallStatus.INSTALL_REQUESTED -> {
Log.i(TAG, "ARCore installation requested.")
false
}
InstallStatus.INSTALLED -> true
}
} catch (e: UnavailableException) {
Log.e(TAG, "ARCore not installed", e)
false
}
}
Availability.UNSUPPORTED_DEVICE_NOT_CAPABLE ->
// This device is not supported for AR.
false
Availability.UNKNOWN_CHECKING -> {
// ARCore is checking the availability with a remote query.
// This function should be called again after waiting 200 ms to determine the query result.
}
Availability.UNKNOWN_ERROR, Availability.UNKNOWN_TIMED_OUT -> {
// There was an error checking for AR availability. This may be due to the device being offline.
// Handle the error appropriately.
}
}
}
สร้างเซสชัน
สร้างและกำหนดค่าเซสชันใน ARCore
Java
public void createSession() {
// Create a new ARCore session.
session = new Session(this);
// Create a session config.
Config config = new Config(session);
// Do feature-specific operations here, such as enabling depth or turning on
// support for Augmented Faces.
// Configure the session.
session.configure(config);
}
Kotlin
fun createSession() {
// Create a new ARCore session.
session = Session(this)
// Create a session config.
val config = Config(session)
// Do feature-specific operations here, such as enabling depth or turning on
// support for Augmented Faces.
// Configure the session.
session.configure(config)
}
ปิดเซสชัน
Session
เป็นเจ้าของหน่วยความจำฮีพดั้งเดิมในปริมาณมาก หากไม่ปิดเซสชันอย่างชัดเจน
อาจทำให้หน่วยความจำในเครื่องเต็มและขัดข้อง เมื่อไม่จำเป็นต้องใช้เซสชัน AR อีกต่อไป ให้เรียกใช้ close()
เพื่อปล่อยทรัพยากร หากแอปมีกิจกรรมเดียวที่เปิดใช้ AR ให้เรียกใช้ close()
จากเมธอด onDestroy()
ของกิจกรรม
Java
// Release native heap memory used by an ARCore session.
session.close();
Kotlin
// Release native heap memory used by an ARCore session.
session.close()