CameraManager.AvailabilityCallback.OnPhysicalCameraUnavailable 方法

[Android.Runtime.Register("onPhysicalCameraUnavailable", "(Ljava/lang/String;Ljava/lang/String;)V", "GetOnPhysicalCameraUnavailable_Ljava_lang_String_Ljava_lang_String_Handler", ApiSince=30)]
public virtual void OnPhysicalCameraUnavailable(string cameraId, string physicalCameraId);

[<Android.Runtime.Register("onPhysicalCameraUnavailable", "(Ljava/lang/String;Ljava/lang/String;)V", "GetOnPhysicalCameraUnavailable_Ljava_lang_String_Ljava_lang_String_Handler", ApiSince=30)>]
abstract member OnPhysicalCameraUnavailable : string * string -> unit
override this.OnPhysicalCameraUnavailable : string * string -> unit

參數

屬性

RegisterAttribute

備註

原本可用的實體攝影機已無法使用。

預設情況下，如果邏輯多鏡頭本身無法使用，所有實體攝影機都無法使用。 當 #onCameraUnavailable 邏輯多鏡頭被呼叫時，不會呼叫其父邏輯多鏡頭的任何實體攝影機。

若 < ，開啟邏輯攝影機會禁用 及其實體攝影機的回調。 例如，如果應用程式A開啟相機裝置：

<UL>

<li>所有訂閱 ActivityCallback 的應用程式都獲得 #onCameraUnavailable。</李>

<li>沒有應用程式（包括應用程式 A）訂閱 ActivityCallback 會收到 #onPhysicalCameraAvailable 或 #onPhysicalCameraUnavailable，因為邏輯攝影機無法使用（有應用程式正在使用）。</李>

</ul>

若 android.content.pm.ApplicationInfo#targetSdkVersion targetSdkVersion & ge; android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKE：

<UL>

<li>物理攝影機狀態變更會觸發 #onPhysicalCameraAvailable ，甚至 #onPhysicalCameraUnavailable 在邏輯攝影機無法使用後。 #onCameraUnavailable呼叫邏輯攝影機並不會重置實體攝影機的可用性狀態。 這使得應用程式開啟邏輯攝影機裝置時，能知道哪台實體攝影機變得無法使用或可用。</李>

<li>與先前類似 android.os.Build.VERSION_CODES#TIRAMISU Android 13 ，邏輯攝影機 #onCameraAvailable 的回調意味著所有實體攝影機的狀態都會被公開。 #onPhysicalCameraUnavailable 當邏輯攝影機啟用時，將呼叫任何無法使用的實體攝影機。</李>

</ul>

由於攝影機擷取的管線特性 android.hardware.camera2.CaptureRequest，若應用程式向邏輯多攝影機的實體攝影機請求影像，而該實體攝影機無法使用，可能會發生影格掉落。 應用程式應在收到無法使用的實體攝影機 #onPhysicalCameraUnavailable 後立即停止直接請求，並準備好對針對實體攝影機的請求進行穩健處理掉幀錯誤，因為這些錯誤可能在無法回撥之前就已發生。

此方法的預設實作不會執行任何動作。

Java 文件 android.hardware.camera2.CameraManager.AvailabilityCallback.onPhysicalCameraUnavailable(java.lang.String, java.lang.String)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。