หากต้องการใช้การเพิ่มแสงในสภาวะแสงน้อยของ Google คุณจะต้องมี ไคลเอ็นต์การเพิ่มแสงในสภาวะแสงน้อย
คุณสามารถใช้
ไคลเอ็นต์เพื่อตรวจสอบว่าได้ติดตั้งโมดูลการเพิ่มแสงในสภาวะแสงน้อยแล้วหรือไม่ รวมถึงตรวจสอบ
ว่าอุปกรณ์และกล้องที่แอปของคุณ
ทำงานอยู่รองรับการเพิ่มแสงในสภาวะแสงน้อยของ Google หรือไม่ นอกจากนี้ คุณยังใช้ไคลเอ็นต์เพื่อสร้าง LowLightBoostSession ด้วย
(คุณจะใช้เซสชัน เพื่อเปิดและปิดการเพิ่มแสงในสภาวะแสงน้อย) นอกจากนี้ คุณยัง
ตั้งค่า Listener เพื่อรับการเรียกกลับเมื่อการเพิ่มแสงในสภาวะแสงน้อยทำงานอยู่ได้ด้วย
เมธอด LowLightBoostClient ไม่ได้ส่งสัญญาณความสำเร็จหรือความล้มเหลวโดยตรง แต่จะแสดงผล
ออบเจ็กต์ Task แทน คุณใช้ Task เพื่อตั้งค่า Listener สำหรับความสำเร็จและความล้มเหลว
ซึ่งจะช่วยให้เมธอดส่งสัญญาณความสำเร็จหรือความล้มเหลวแบบไม่พร้อมกันได้ ซึ่ง
จำเป็นเนื่องจากเมธอดต้องสื่อสารกับ Google Play Services
เมืองขึ้น
Kotlin
dependencies {
val low_light_boost_version = "16.0.1-beta04"
implementation("org.jetbrains.kotlinx:kotlinx-coroutines-play-services:1.10.2")
implementation("com.google.android.gms:play-services-base:18.7.0")
implementation("com.google.android.gms:play-services-camera-low-light-boost:${low_light_boost_version}")
implementation("com.google.android.gms:play-services-tasks:18.3.0")
}
ดึงดูด
dependencies {
def low_light_boost_version = "16.0.1-beta04"
implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-play-services:1.10.2'
implementation 'com.google.android.gms:play-services-base:18.7.0'
implementation 'com.google.android.gms:play-services-camera-low-light-boost:${low_light_boost_version}'
implementation 'com.google.android.gms:play-services-tasks:18.3.0'
}
LowLightBoostClient ให้บริการโดยแพ็กเกจของ Google Play Services
com.google.android.gms.cameralowlight ดูข้อมูลเกี่ยวกับการเข้าถึง Google Play Services API ได้ในเอกสารประกอบของ Google
Play services
สร้างไคลเอ็นต์
คุณต้องมีไคลเอ็นต์การเพิ่มแสงในสภาวะแสงน้อยจึงจะดำเนินการอื่นๆ ได้ โค้ดต่อไปนี้ จะสร้างไคลเอ็นต์
Kotlin
val lowLightBoostClient = LowLightBoost.getClient(context)
Java
LowLightBoostClient lowLightBoostClient = LowLightBoost.getClient(context);
ประเด็นสำคัญเกี่ยวกับโค้ดนี้
- คลาส
LowLightBoostมีเมธอดแบบคงที่getClient, ซึ่งแสดงผลอินสแตนซ์ของLowLightBoostClient
ตรวจสอบว่ารองรับการเพิ่มแสงในสภาวะแสงน้อยหรือไม่
เมื่อมีไคลเอ็นต์แล้ว คุณจะตรวจสอบได้ว่าอุปกรณ์ที่แอปทำงานอยู่รองรับการเพิ่มแสงในสภาวะแสงน้อยหรือไม่ โค้ดต่อไปนี้จะตรวจสอบว่ารองรับการเพิ่มแสงในสภาวะแสงน้อยหรือไม่
Kotlin
launch {
try {
// Await the result of the Task in a non-blocking way
val isSupported: Boolean = lowLightBoostClient
.isCameraSupported(cameraId).await()
Log.d(TAG, "isCameraSupported: $isSupported")
if (isSupported) {
// Create the low light boost session here
}
} catch (e: Exception) {
Log.e(TAG, "isCameraSupported failed", e)
}
}
Java
lowLightBoostClient
.isCameraSupported(cameraId)
.addOnSuccessListener(
lowLightBoostExecutor,
(isSupported) -> {
Log.d(TAG, "isCameraSupported: " + isSupported);
if (isSupported) {
// Create the low light boost session here
}
)
ประเด็นสำคัญเกี่ยวกับโค้ดนี้
cameraIdถือว่าเป็น รหัสของกล้อง Camera2 ที่สร้างขึ้นที่อื่นLowLightBoostClient.isCameraSupported()จะตรวจสอบว่ากล้อง Camera2 รองรับการเพิ่มแสงในสภาวะแสงน้อยหรือไม่ ในบางกรณี อุปกรณ์อาจรองรับการเพิ่มแสงในสภาวะแสงน้อย แต่กล้องตัวใดตัวหนึ่งอาจไม่รองรับ ดังนั้นคุณจึงต้องตรวจสอบทั้งอุปกรณ์และกล้อง- เมธอด
LowLightBoostClient.isCameraSupported()จะแสดงผลTaskออบเจ็กต์ คุณใช้ออบเจ็กต์นี้เพื่อตั้งค่า Listener สำหรับความสำเร็จและความล้มเหลว สร้าง เซสชันการเพิ่มแสงในสภาวะแสงน้อยภายใน Listener สำหรับความสำเร็จ
ตรวจสอบว่าได้ติดตั้งโมดูลการเพิ่มแสงในสภาวะแสงน้อยแล้วหรือไม่
เมื่อมีไคลเอ็นต์แล้ว คุณจะยืนยันได้ว่าได้ติดตั้งโมดูลการเพิ่มแสงในสภาวะแสงน้อยในอุปกรณ์แล้วหรือไม่ โค้ดต่อไปนี้จะตรวจสอบว่าได้ติดตั้งโมดูลแล้วหรือไม่
Kotlin
// Handle the Google Play services Task API with Kotlin coroutines
// (kotlinx-coroutines-play-services)
launch {
try {
val isInstalled: Boolean = lowLightBoostClient
.isModuleInstalled(context).await()
if (isInstalled) {
Log.d(TAG, "Module is installed")
try {
openCamera(cameraId)
} catch (e: CameraAccessException) {
Log.e(TAG, "Failed to open camera", e)
}
} else {
Log.d(TAG, "Module is not installed")
launchInstallRequest()
}
} catch (e: Exception) {
Log.e(TAG, "Failed to check module availability", e)
}
}
Java
lowLightBoostClient
.isModuleInstalled(context)
.addOnSuccessListener(
(isInstalled) -> {
if (isInstalled) {
Log.d(TAG, "Module is installed");
try {
openCamera(cameraId);
} catch (CameraAccessException e) {
Log.e(TAG, "Failed to open camera", e);
}
} else {
Log.d(TAG, "Module is not installed");
launchInstallRequest();
}
})
.addOnFailureListener(
(e) -> {
Log.e(TAG, "Failed to check module availability", e);
});
ประเด็นสำคัญเกี่ยวกับโค้ดนี้
- โค้ดนี้จะเปิดเซสชันกล้องเพื่อเชื่อมต่อกับกล้องที่ระบุโดย
cameraIdดูข้อมูลเพิ่มเติมได้ในเอกสารประกอบของ Camera2 documentation - เมธอด
LowLightBoostClient.isModuleInstalled()จะแสดงผลออบเจ็กต์Taskคุณใช้ออบเจ็กต์นี้เพื่อตั้งค่า Listener สำหรับความสำเร็จและความล้มเหลว - ใช้
Task.addOnSuccessListener()เพื่อตั้งค่า Listener ที่จะเรียกใช้หากการ เรียกใช้isModuleInstalled()สำเร็จ สิ่งสำคัญคือ หากมีการเรียกใช้ Listener สำหรับความสำเร็จ ก็จะบอกคุณได้เพียงว่าไคลเอ็นต์ค้นหา ว่า ได้ติดตั้งโมดูลในอุปกรณ์แล้วหรือไม่ คุณต้องตรวจสอบว่าได้ติดตั้งโมดูลแล้วจริงหรือไม่ในเนื้อหาของ Listener - หากยังไม่ได้ติดตั้งโมดูล สนิปเพ็ตนี้จะติดตั้งโมดูลโดยการเรียกใช้
เมธอด
launchInstallRequest()ซึ่งเมธอดดังกล่าวจะกำหนดไว้ในสนิปเพ็ตในหัวข้อ ติดตั้งโมดูลการเพิ่มแสงในสภาวะแสงน้อย
ติดตั้งโมดูลการเพิ่มแสงในสภาวะแสงน้อย
หากยังไม่ได้ติดตั้งโมดูลการเพิ่มแสงในสภาวะแสงน้อยในอุปกรณ์ คุณจะต้อง ดาวน์โหลดและติดตั้งโมดูลจาก Google Play Services โค้ดนี้แสดงวิธีดำเนินการ
Kotlin
private suspend fun launchInstallRequest() {
Log.v(TAG, "Launching install request")
try {
// Check if this device can support Google LLB.
val isDeviceSupported: Boolean = lowLightBoostClient
.isDeviceSupported(context).await()
if (isDeviceSupported) {
Log.d(TAG, "Device is supported")
// Show download indicator, if needed.
try {
val isInstallSuccessful: Boolean = lowLightBoostClient
.installModule(context,
createInstallStatusCallback()
).await()
if (isInstallSuccessful) {
Log.d(TAG, "Module installed")
// Hide download indicator, if needed.
try {
openCamera()
} catch (e: CameraAccessException) {
Log.e(TAG, "Failed to open camera", e)
}
} else {
Log.d(TAG, "Module install failed")
}
} catch (e: Exception) {
Log.e(TAG, "An error occurred installing the module:", e)
}
} else {
Log.d(TAG, "Device is not supported")
}
} catch (e: Exception) {
Log.e(TAG, "An error occurred checking device support:", e)
}
}
Java
private void launchInstallRequest() {
Log.v(TAG, "Launching install request");
// Check if this device can support Google LLB.
lowLightBoostClient
.isDeviceSupported(context)
.addOnSuccessListener(
(isDeviceSupported) -> {
if (isDeviceSupported) {
Log.d(TAG, "Device is supported");
// Show download indicator, if needed.
lowLightBoostClient
.installModule(
this,
createInstallStatusCallback()
)
.addOnSuccessListener(
(result) -> {
if (result) {
Log.d(TAG, "Module installed");
// Hide download indicator, if needed.
try {
openCamera();
} catch (CameraAccessException e) {
Log.e(TAG, "Failed to open camera", e);
}
} else {
Log.d(TAG, "Module install failed");
}
}
);
} else {
Log.d(TAG, "Device is not supported");
}
})
.addOnFailureListener(
(e) -> {
Log.e(TAG, "Failed to check device support", e);
});
}
ประเด็นสำคัญเกี่ยวกับโค้ดนี้
- เมื่อเรียกใช้
LowLightBoostClient.installModule()คุณจะส่งออบเจ็กต์การเรียกกลับ ซึ่งใช้LowLightBoostClient.InstallStatusCallbackinstallModule()จะเรียกใช้เมธอดในการเรียกกลับนั้นเพื่อระบุสถานะของ การดาวน์โหลด เช่น หากการดาวน์โหลดหยุดชั่วคราวinstallModule()จะเรียกใช้ เมธอดonDownloadPause()ของออบเจ็กต์การเรียกกลับ - ในสนิปเพ็ตโค้ดนี้ ออบเจ็กต์การเรียกกลับจะสร้างขึ้นโดยเมธอด
createInstallStatusCallback()คุณจะต้องเขียนเมธอดนั้น เองตามแนวทางต่อไปนี้
Kotlin
private fun createInstallStatusCallback(): LowLightBoostClient.InstallStatusCallback =
object : LowLightBoostClient.InstallStatusCallback() {
override fun onDownloadPending() {
Log.d(TAG, "onDownloadPending")
// Code here...
}
override fun onDownloadStart() {
Log.d(TAG, "onDownloadStart")
// Code here...
}
// other overrides here...
}
Java
private InstallStatusCallback createInstallStatusCallback() {
new LowLightBoostClient.InstallStatusCallback() {
@Override
public void onDownloadPending() {
Log.d(TAG, "onDownloadPending");
// Code here...
}
@Override
public void onDownloadStart() {
Log.d(TAG, "onDownloadStart");
// Code here...
}
// other overrides here...
}
LowLightBoostClient.isDeviceSupported()จะตรวจสอบว่าอุปกรณ์และระบบปฏิบัติการที่ใช้ Android รองรับการเพิ่มแสงในสภาวะแสงน้อยของ Google หรือไม่ หากไม่รองรับ ก็อย่าดาวน์โหลดโมดูลเมธอด
LowLightBoostClient.installModule()จะแสดงผลออบเจ็กต์Taskคุณใช้ออบเจ็กต์นี้เพื่อตั้งค่า Listener สำหรับความสำเร็จและความล้มเหลวเมื่อการติดตั้งเสร็จสมบูรณ์ Listener สำหรับความสำเร็จจะยืนยันการติดตั้งโดยการ เปิดกล้อง ในสนิปเพ็ตนี้ การดำเนินการดังกล่าวจะทำได้โดยการเรียกใช้
openCamera()คุณจะต้องเขียนเมธอดนั้นเอง