ใช้เซสชันการเพิ่มแสงในสภาวะแสงน้อยเพื่อเปิดและปิดการเพิ่มแสงในสภาวะแสงน้อยของ Google
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'
}
LowLightBoostSession มีให้บริการในแพ็กเกจบริการ Google Play com.google.android.gms.cameralowlight ดูข้อมูลเกี่ยวกับการเข้าถึง API ของบริการ Google Play ได้ในเอกสารประกอบของบริการ Google Play
สร้างออบเจ็กต์ Callback
เมื่อสร้างเซสชันการเพิ่มคุณภาพในที่แสงน้อย คุณจะต้องส่งออบเจ็กต์ที่ใช้อินเทอร์เฟซ LowLightBoostCallback
ระบบจะเรียกใช้ฟังก์ชันของออบเจ็กต์นี้เมื่อเซสชันถูกยกเลิกการเชื่อมต่อหรือถูกทำลาย โค้ดต่อไปนี้แสดงวิธีสร้าง Callback
Kotlin
private fun createLowLightBoostCallback(): LowLightBoostCallback = object : LowLightBoostCallback { override fun onSessionDestroyed() { Log.d(TAG, "onSessionDestroyed") lowLightBoostSession = null } override fun onSessionDisconnected(statusCode: Status) { Log.d(TAG, "onSessionDisconnected: error=$statusCode") lowLightBoostSession = null } }
Java
private LowLightBoostCallback createLowLightBoostCallback() {
LowLightBoostCallback lowLightBoostCallback = new LowLightBoostCallback() {
@Override
public void onSessionDestroyed() {
Log.d(TAG, "onSessionDestroyed");
lowLightBoostSession = null;
}
@Override
public void onSessionDisconnected(int statusCode) {
Log.d(TAG, "onSessionCreationFailed: error=" + statusCode);
lowLightBoostSession = null;
}
}
return lowLightBoostCallback;
}
ประเด็นสำคัญเกี่ยวกับรหัสนี้
- โค้ดนี้กำหนดเมธอดส่วนตัว
createLowLightBoostCallback()ซึ่งจะสร้างออบเจ็กต์ Callback คุณจะเรียกใช้เมธอดนั้นเมื่อสร้างเซสชันการเพิ่มคุณภาพในที่แสงน้อยจริงๆ ตามที่อธิบายไว้ในสร้างเซสชัน - ระบบจะเรียกใช้ Callback เมื่อเซสชันถูกยกเลิกการเชื่อมต่อหรือถูกทำลาย ระบบจะไม่เรียกใช้เมื่อสร้างเซสชัน หากต้องการตรวจสอบว่าสร้างเซสชันสำเร็จหรือไม่ ให้ตรวจสอบออบเจ็กต์
Taskที่LowLightBoostClient.createSessionแสดงผล
สร้างเซสชัน
หากต้องการสร้างเซสชันแสงน้อย ให้เรียกใช้เมธอด LowLightBoostClient.createSession
Kotlin
val options = LowLightBoostOptions( previewSurface, cameraId, previewWidth, previewHeight, enableLowLightBoost ) launch { try { val lowLightBoostSession = lowLightBoostClient .createSession(options, createLowLightBoostCallback()).await() Log.d(TAG, "Session created successfully") // Get the surface from the LLB session; // give it to camera so camera can write frames to it. } catch (e: CancellationException) { Log.w(TAG, "Session creation was canceled", e) lowLightBoostSession = null } catch (e: ApiException) { Log.e(TAG, "Session creation failed with ApiException:", e) lowLightBoostSession = null } catch (e: Exception) { Log.e(TAG, "Session creation failed with Exception", e) lowLightBoostSession = null } }
Java
LowLightBoostOptions options = new LowLightBoostOptions(
previewSurface,
cameraId,
previewWidth,
previewHeight,
enableLowLightBoost);
lowLightBoostClient
.createSession(options, createLowLightBoostCallback())
.addOnSuccessListener(
lowLightBoostExecutor,
(session) -> {
Log.d(TAG, "Session created successfully");
// Get the surface from the LLB session;
// give it to camera so camera can write frames to it
})
.addOnFailureListener(
lowLightBoostExecutor,
(e) -> {
ApiException apiException = (ApiException) e;
Log.d(TAG, "Session creation failed: " + e);
lowLightBoostSession = null;
})
.addOnCompleteListener(
lowLightBoostExecutor,
(task) -> Log.d(TAG, "Session creation complete"))
.addOnCanceledListener(
lowLightBoostExecutor,
() -> {
throw new RuntimeException("Session creation canceled");
});
ประเด็นสำคัญเกี่ยวกับรหัสนี้
- คุณส่งออบเจ็กต์
LowLightBoostOptionsไปยังcreateSession()เพื่อกำหนดค่าเซสชัน ออบเจ็กต์นี้จะระบุสิ่งต่างๆ เช่น พื้นผิวเป้าหมาย รหัสของกล้องที่จะใช้ และขนาดของตัวอย่าง - โค้ดนี้ถือว่าคุณได้เปิดการเชื่อมต่อกับกล้อง Camera2 แล้ว และใช้ข้อมูลดังกล่าวเพื่อตั้งค่า
cameraId, previewWidth, previewHeightดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบของ Camera2 enableLowLightBoostคือค่าบูลีนที่ระบุว่าควรเปิดหรือปิดการเพิ่มคุณภาพวิดีโอในที่แสงน้อยเมื่อเริ่มต้นcreateLowLightBoostCallbackคือเมธอดที่คุณเขียนเพื่อสร้างออบเจ็กต์ Callback ระบบจะเรียกใช้ออบเจ็กต์นี้เมื่อเซสชันถูกยกเลิกการเชื่อมต่อหรือถูกทำลาย- เมธอด
LowLightBoostClient.createSession()จะแสดงผลออบเจ็กต์Taskคุณใช้ออบเจ็กต์นี้เพื่อตั้งค่า Listener ที่สำเร็จและไม่สำเร็จ บันทึกวิดีโอภายใน Listener ที่ประสบความสำเร็จ - คุณสามารถระบุ
Executorเพื่อเรียกใช้ Listener ได้ หากคุณไม่ระบุExecutorListener จะทำงานในชุดข้อความหลัก ในโค้ดนี้ เราถือว่าlowLightBoostExecutorเป็นExecutorที่เหมาะสม
ส่งผลการจับภาพ
ฟีเจอร์เพิ่มคุณภาพในที่แสงน้อยของ Google ต้องใช้ข้อมูลเมตาบางอย่างของกล้องเพื่อให้ทราบปริมาณการเพิ่มความสว่างที่เหมาะสม คุณต้องส่ง TotalCaptureResult ไปยังเมธอด processCaptureResult() คุณสามารถดู TotalCaptureResult ได้ในเมธอด Callback onCaptureCompleted()
Kotlin
val captureCallback = object : CameraCaptureSession.CaptureCallback() { override fun onCaptureCompleted( session: CameraCaptureSession, request: CaptureRequest, result: TotalCaptureResult ) { super.onCaptureCompleted(session, request, result) lowLightBoostSession?.processCaptureResult(result) } }
Java
CameraCaptureSession.CaptureCallback captureCallback =
new CameraCaptureSession.CaptureCallback() {
@Override
public void onCaptureCompleted(
@NonNull CameraCaptureSession session,
@NonNull CaptureRequest request,
@NonNull TotalCaptureResult result) {
super.onCaptureCompleted(session, request, result)
if (lowLightBoostSession != null) {
lowLightBoostSession.processCaptureResult(result);
}
}
};
ประเด็นสำคัญเกี่ยวกับรหัสนี้
- รหัสนี้แสดงเฉพาะรหัส
CaptureCallbackที่เกี่ยวข้องกับ Google LLB คุณอาจมีโค้ดอื่นๆ ใน Callback เหล่านี้ - การส่งผ่าน
TotalCaptureResultช่วยให้ Google LLB วิเคราะห์ข้อมูลการเปิดรับแสงอัตโนมัติและข้อมูลเมตาอื่นๆ ที่จำเป็นสำหรับโหมดเพิ่มความสว่างในที่แสงน้อยเพื่อประมวลผลการตรวจจับฉากและกำหนดระดับการเพิ่มความสว่างที่จะใช้กับเฟรมได้ - คุณควรส่งออบเจ็กต์
captureCallbackเมื่อสร้างเซสชันกล้อง เช่น ด้วย `setSingleRepeatingRequest()
เริ่มการแสดงตัวอย่างจากกล้อง
เมื่อสร้างเซสชันแสงน้อยแล้ว คุณจะเริ่มสตรีมตัวอย่างภาพจากกล้องได้ คุณควรดำเนินการนี้ภายใน Callback onSuccess() ที่ส่งไปยังเซสชันแสงน้อยตามที่อธิบายไว้ในสร้างเซสชัน โค้ดต่อไปนี้แสดงวิธีจับภาพวิดีโอ
Kotlin
MainActivity.this.lowLightBoostSession =
lowLightBoostSession
MainActivity.this.lowLightBoostSession
.setSceneDetectorCallback(
(lowLightBoostSession, boostStrength) -> {
Log.d(TAG, "onSceneBrightnessChanged: " +
"boostStrength=$boostStrength")
// boostStrength > 0.5 indicates a low light scene.
// Update UI accordingly.
},
lowLightBoostExecutor
)
try {
startCaptureSession(
lowLightBoostSession.getCameraSurface())
// Start a Camera2 session here. Pass the LLB surface
// to the camera so the camera can write frames to it.
} catch (e: CameraAccessException) {
Log.e(TAG, "Failed to start capture session", e)
// Must try again or start the capture session without LLB.
}
Java
MainActivity.this.lowLightBoostSession =
lowLightBoostSession;
MainActivity.this.lowLightBoostSession
.setSceneDetectorCallback(
(lowLightBoostSession, boostStrength) -> {
Log.d(TAG, "onSceneBrightnessChanged: " +
"boostStrength=" + boostStrength);
// boostStrength > 0.5 indicates a low light scene.
// Update UI accordingly.
},
lowLightBoostExecutor
);
try {
startCaptureSession(
lowLightBoostSession.getCameraSurface());
// Start a Camera2 session here. Pass the LLB surface
// to the camera so the camera can write frames to it.
} catch (CameraAccessException e) {
Log.e(TAG, "Failed to start capture session", e);
// Must try again or start the capture session without LLB.
}
ประเด็นสำคัญเกี่ยวกับรหัสนี้
lowLightBoostSessionคือเซสชันที่คุณสร้างในสร้างเซสชันsetSceneDetectorCallback()กำหนดออบเจ็กต์ Callback ที่ใช้อินเทอร์เฟซSceneDetectorCallbackเซสชันจะเรียกใช้เมธอดonSceneBrightnessChanged()ของออบเจ็กต์นั้นเมื่อความสว่างของฉากเปลี่ยนไป การติดตั้งใช้งานของคุณควรปรับ UI ของกล้องอย่างเหมาะสม- คุณสามารถระบุ
Executorเพื่อเรียกใช้ Callback ได้ หากคุณไม่ระบุExecutorคอลแบ็กจะทำงานในชุดข้อความหลัก ในโค้ดนี้ เราถือว่าlowLightBoostExecutorเป็นExecutorที่เหมาะสม lowLightBoostSession.getCameraSurface()แสดงผลSurfaceพร้อมวิดีโอที่บันทึกไว้
ปล่อยเซสชัน
เมื่อกล้องไม่ได้ใช้งานแล้ว ให้ปล่อยเซสชันการเพิ่มคุณภาพในที่แสงน้อยโดยเรียกใช้ LowLightBoostSession.release() โดยเฉพาะอย่างยิ่ง คุณควรตรวจสอบว่าได้ปล่อยเซสชันเมื่อกิจกรรมถูกทำลาย คุณทำได้โดยเรียกใช้เมธอดในเมธอด onDestroy() ของกิจกรรม ดังนี้
Kotlin
override protected void onDestroy() {
super.onDestroy()
if (lowLightBoostSession != null) {
lowLightBoostSession.release()
lowLightBoostSession = null
}
}
Java
@Override
protected void onDestroy() {
super.onDestroy();
if (lowLightBoostSession != null) {
lowLightBoostSession.release();
lowLightBoostSession = null;
}
}
ประเด็นสำคัญเกี่ยวกับรหัสนี้
- หลังจากเซสชันถูกปล่อยแล้ว คุณไม่ควรเรียกใช้เมธอดใดๆ ของเซสชันนั้น คุณควรล้างตัวแปรที่ชี้ไปยังเซสชัน เช่นเดียวกับที่โค้ดนี้ทำ