หากต้องการใช้การเพิ่มแสงในสภาวะแสงน้อยของ Google คุณจะต้องมีไคลเอ็นต์การเพิ่มแสงในสภาวะแสงน้อย
คุณสามารถใช้ไคลเอ็นต์เพื่อตรวจสอบว่ามีการติดตั้งโมดูลการเพิ่มคุณภาพในที่แสงน้อยหรือไม่ และตรวจสอบว่าอุปกรณ์และกล้องที่แอปของคุณทำงานอยู่รองรับการเพิ่มคุณภาพในที่แสงน้อยของ Google หรือไม่ นอกจากนี้ คุณยังใช้ไคลเอ็นต์เพื่อสร้าง LowLightBoostSession ได้ด้วย
(คุณจะใช้เซสชันเพื่อเปิดและปิดการเพิ่มประสิทธิภาพในสภาวะแสงน้อย) นอกจากนี้ คุณยังตั้งค่า Listener เพื่อรับ Callback เมื่อการเพิ่มคุณภาพในที่แสงน้อยทำงานอยู่ได้ด้วย
เมธอด LowLightBoostClient ไม่ได้ส่งสัญญาณความสำเร็จหรือความล้มเหลวโดยตรง แต่จะแสดงผลออบเจ็กต์ Task แทน คุณใช้ Task เพื่อตั้งค่า Listener สำหรับการดำเนินการที่สำเร็จและไม่สำเร็จ ซึ่งจะช่วยให้เมธอดส่งสัญญาณความสำเร็จหรือความล้มเหลวแบบอะซิงโครนัสได้ ซึ่งจำเป็นเนื่องจากเมธอดต้องสื่อสารกับบริการ Google Play
ความสัมพันธ์
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 มีให้บริการในแพ็กเกจ com.google.android.gms.cameralowlight ของบริการ Google Play ดูข้อมูลเกี่ยวกับการเข้าถึง API ของบริการ Google Play ได้ในเอกสารประกอบของบริการ Google Play
สร้างไคลเอ็นต์
คุณต้องมีไคลเอ็นต์การเพิ่มคุณภาพในที่แสงน้อยเพื่อดำเนินการอื่นๆ โค้ดต่อไปนี้จะสร้างไคลเอ็นต์
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 รองรับการเพิ่มคุณภาพในที่แสงน้อยหรือไม่ ในบางกรณี อุปกรณ์อาจรองรับการเพิ่มคุณภาพในที่แสงน้อย แต่กล้องตัวใดตัวหนึ่งอาจไม่รองรับ คุณจึงต้องตรวจสอบทั้ง 2 อย่าง- เมธอด
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().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 - เมธอด
LowLightBoostClient.isModuleInstalled()จะแสดงผลออบเจ็กต์Taskคุณใช้ออบเจ็กต์นี้เพื่อตั้งค่า Listener ที่สำเร็จและไม่สำเร็จ - ใช้
Task.addOnSuccessListener()เพื่อตั้งค่า Listener ที่จะเรียกใช้หากการเรียกisModuleInstalled()สำเร็จ สิ่งสำคัญคือ หากมีการเรียกใช้ Listener ที่ประสบความสำเร็จ นั่นหมายความว่าไคลเอ็นต์ค้นพบว่ามีการติดตั้งโมดูลในอุปกรณ์หรือไม่ ในเนื้อหาของ Listener คุณต้องตรวจสอบว่ามีการติดตั้งโมดูลจริงหรือไม่ - หากยังไม่ได้ติดตั้งโมดูล ข้อมูลโค้ดนี้จะติดตั้งโมดูลโดยเรียกใช้เมธอด
launchInstallRequest()เมธอดดังกล่าวจะกำหนดไว้ในข้อมูลโค้ดในส่วนติดตั้งโมดูลการเพิ่มคุณภาพแสงน้อย
ติดตั้งโมดูลการเพิ่มแสงในสภาวะแสงน้อย
หากยังไม่ได้ติดตั้งโมดูลการเพิ่มความสว่างในที่แสงน้อยในอุปกรณ์ คุณจะต้องดาวน์โหลดและติดตั้งโมดูลดังกล่าวจากบริการ Google Play โค้ดนี้แสดงวิธีดำเนินการดังกล่าว
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().await() if (isDeviceSupported) { Log.d(TAG, "Device is supported") // Show download indicator, if needed. try { val isInstallSuccessful: Boolean = lowLightBoostClient .installModule( 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()คุณจะส่งออบเจ็กต์ Callback ซึ่งใช้LowLightBoostClient.InstallStatusCallbackinstallModule()จะเรียกใช้เมธอดใน Callback นั้นเพื่อระบุสถานะของการดาวน์โหลด ตัวอย่างเช่น หากการดาวน์โหลดหยุดชั่วคราวinstallModule()จะเรียกใช้เมธอดonDownloadPause()ของออบเจ็กต์ Callback ในข้อมูลโค้ดนี้ ออบเจ็กต์ Callback จะสร้างขึ้นโดยเมธอด
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()คุณจะต้องเขียนเมธอดนั้นด้วยตนเอง