ใช้เซสชันการเพิ่มแสงในสภาวะแสงน้อยเพื่อเปิดและปิดการเพิ่มแสงในสภาวะแสงน้อยของ Google
Kotlin
dependencies {
val low_light_boost_version = "16.0.0-beta01"
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")
}
Groovy
dependencies {
def low_light_boost_version = "16.0.0-beta01"
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
สร้างออบเจ็กต์การเรียกกลับ
เมื่อสร้างเซสชันการเพิ่มคุณภาพในโหมดแสงน้อย คุณจะต้องส่งผ่านออบเจ็กต์ที่ใช้อินเทอร์เฟซ LowLightBoostCallback
ระบบจะเรียกใช้ฟังก์ชันของออบเจ็กต์นี้เมื่อเซสชันถูกตัดการเชื่อมต่อหรือถูกทำลาย โค้ดต่อไปนี้แสดงวิธีสร้างการเรียกกลับ
Kotlin
private fun createLowLightBoostCallback(): LowLightBoostCallback =
object : LowLightBoostCallback() {
override fun onSessionDestroyed() {
Log.d(TAG, "onSessionDestroyed")
lowLightBoostSession = null
}
override fun onSessionDisconnected(statusCode: Int) {
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 คุณจะเรียกใช้เมธอดดังกล่าวเมื่อสร้างเซสชันการเพิ่มคุณภาพในโหมดแสงน้อยจริง ตามที่อธิบายไว้ในสร้างเซสชัน - ระบบจะเรียกใช้การเรียกกลับเมื่อเซสชันถูกตัดการเชื่อมต่อหรือถูกทำลาย ระบบจะไม่เรียกใช้เมื่อสร้างเซสชัน หากต้องการตรวจสอบว่าระบบสร้างเซสชันสําเร็จหรือไม่ ให้ตรวจสอบออบเจ็กต์
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
คือเมธอดที่คุณเขียนเพื่อสร้างออบเจ็กต์การเรียกกลับ ระบบจะเรียกใช้ออบเจ็กต์นี้เมื่อเซสชันถูกตัดการเชื่อมต่อหรือถูกทำลาย- เมธอด
LowLightBoostClient.createSession()
จะแสดงผลออบเจ็กต์Task
คุณใช้ออบเจ็กต์นี้เพื่อตั้งค่า Listeners ของความสําเร็จและการไม่สําเร็จ บันทึกวิดีโอภายใน Listener ของเหตุการณ์สำเร็จ - คุณสามารถระบุ
Executor
เพื่อเรียกใช้ Listeners ได้ หากคุณไม่ได้ระบุExecutor
โปรแกรมฟังจะทำงานในเธรดหลัก ในโค้ดนี้ เราถือว่าlowLightBoostExecutor
เป็นExecutor
ที่เหมาะสม
เริ่มแสดงตัวอย่างจากกล้อง
เมื่อสร้างเซสชันที่มีแสงน้อยแล้ว คุณสามารถเริ่มสตรีมตัวอย่างภาพจากกล้องได้ คุณควรทำสิ่งนี้ภายในการเรียกกลับ 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()
กำหนดออบเจ็กต์การเรียกกลับที่ใช้อินเทอร์เฟซSceneDetectorCallback
เซสชันจะเรียกใช้เมธอดonSceneBrightnessChanged()
ของออบเจ็กต์นั้นเมื่อความสว่างของฉากเปลี่ยนแปลง การติดตั้งใช้งานควรปรับ UI ของกล้องให้เหมาะสม- คุณสามารถระบุ
Executor
เพื่อเรียกใช้การเรียกกลับ หากคุณไม่ได้ระบุ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;
}
}
ประเด็นสำคัญเกี่ยวกับรหัสนี้
- หลังจากปล่อยเซสชันแล้ว คุณไม่ควรเรียกใช้เมธอดใดๆ ของเซสชัน คุณควรล้างตัวแปรที่ชี้ไปยังเซสชัน เช่นเดียวกับที่โค้ดนี้ทํา