CameraConstrainedHighSpeedCaptureSession 類別

定義

命名空間:: Android.Hardware.Camera2

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

一個受限高速擷取會話 CameraDevice，用於捕捉來自 CameraDevice 高速影像錄製的使用場景。

[Android.Runtime.Register("android/hardware/camera2/CameraConstrainedHighSpeedCaptureSession", ApiSince=23, DoNotGenerateAcw=true)]
public abstract class CameraConstrainedHighSpeedCaptureSession : Android.Hardware.Camera2.CameraCaptureSession

[<Android.Runtime.Register("android/hardware/camera2/CameraConstrainedHighSpeedCaptureSession", ApiSince=23, DoNotGenerateAcw=true)>]
type CameraConstrainedHighSpeedCaptureSession = class
    inherit CameraCaptureSession

繼承: Object

JavaObject

Object

CameraCaptureSession
CameraConstrainedHighSpeedCaptureSession

屬性: RegisterAttribute

備註

一個受限高速擷取會話 CameraDevice，用於捕捉來自 CameraDevice 高速影像錄製的使用場景。

CameraConstrainedHighSpeedCaptureSession 是透過提供一個的 CameraDevice#createCaptureSession(SessionConfiguration)會話配置來android.hardware.camera2.params.SessionConfiguration#SESSION_HIGH_SPEED建立的。回傳的 CameraCaptureSession.StateCallback CameraCaptureSession 可以投射到 CameraConstrainedHighSpeedCaptureSession。一旦建立，該會話會處於活躍狀態，直到攝影機裝置建立新的會話，或攝影機裝置關閉為止。

主動高速擷取會話是一種專門的擷取會話，僅針對高速錄影>（=120fps）的使用情境，且相機裝置支援高速影像功能（即 CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES 包含 CameraMetadata#REQUEST_AVAILABLE_CAPABILITIES_CONSTRAINED_HIGH_SPEED_VIDEO）。它只接受透過 #createHighSpeedRequestList建立的請求清單，而請求清單只能透過 CameraCaptureSession#captureBurst captureBurst或 CameraCaptureSession#setRepeatingBurst setRepeatingBurst提交至此會話。更多限制細節請參見 CameraDevice#createCaptureSession(android.hardware.camera2.params.SessionConfiguration) 。

建立會話是一項昂貴的操作，可能需要數百毫秒，因為這需要配置相機裝置的內部管線，並分配記憶體緩衝區來傳送影像給目標。因此設定是非同步進行，並 CameraDevice#createConstrainedHighSpeedCaptureSession 會將可用的 CameraCaptureSession 傳送給所提供的監聽者 CameraCaptureSession.StateCallback#onConfigured 回調。若無法完成設定，則會呼叫該 CameraCaptureSession.StateCallback#onConfigureFailed 會話，該會話將不再啟用。

若攝影機裝置建立新會話，則關閉先前會話，並呼叫其相關的 CameraCaptureSession.StateCallback#onClosed onClosed 回調。所有 session 方法在關閉 session 後若被呼叫，都會拋出 IllegalStateException。

封閉會話會清除所有重複的請求（就像 #stopRepeating 被呼叫一樣），但仍會正常完成所有進行中的擷取請求，然後新建立的會話接手並重新配置攝影機裝置。

Java 文件 android.hardware.camera2.CameraConstrainedHighSpeedCaptureSession。

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

建構函式

名稱	Description
CameraConstrainedHighSpeedCaptureSession()	一個受限高速擷取會話 `CameraDevice`，用於捕捉來自 `CameraDevice` 高速影像錄製的使用場景。
CameraConstrainedHighSpeedCaptureSession(IntPtr, JniHandleOwnership)	一個受限高速擷取會話 `CameraDevice`，用於捕捉來自 `CameraDevice` 高速影像錄製的使用場景。

屬性

名稱	Description
Class	回傳此 `Object`的執行時類別。 (繼承來源 Object)
Device	取得本會話所設計的攝影機裝置。 (繼承來源 CameraCaptureSession)
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
InputSurface	取得與可再生擷取會話相關的輸入 Surface。 (繼承來源 CameraCaptureSession)
IsReprocessable	如果應用程式能用此相機擷取會話提交重新處理擷取請求，請回傳。 (繼承來源 CameraCaptureSession)
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	一個受限高速擷取會話 `CameraDevice`，用於捕捉來自 `CameraDevice` 高速影像錄製的使用場景。 (繼承來源 JavaObject)
JniPeerMembers	一個受限高速擷取會話 `CameraDevice`，用於捕捉來自 `CameraDevice` 高速影像錄製的使用場景。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
ThresholdClass	一個受限高速擷取會話 `CameraDevice`，用於捕捉來自 `CameraDevice` 高速影像錄製的使用場景。
ThresholdType	一個受限高速擷取會話 `CameraDevice`，用於捕捉來自 `CameraDevice` 高速影像錄製的使用場景。

方法

名稱	Description
AbortCaptures()	盡快丟棄所有目前待捕獲或進行中的捕獲。 (繼承來源 CameraCaptureSession)
Capture(CaptureRequest, CameraCaptureSession+CaptureCallback, Handler)	請提交由相機裝置拍攝影像的請求。 (繼承來源 CameraCaptureSession)
CaptureBurst(IList<CaptureRequest>, CameraCaptureSession+CaptureCallback, Handler)	提交一份請求清單，依序以突發方式擷取。 (繼承來源 CameraCaptureSession)
CaptureBurstRequests(IList<CaptureRequest>, IExecutor, CameraCaptureSession+CaptureCallback)	提交一份請求清單，依序以突發方式擷取。 (繼承來源 CameraCaptureSession)
CaptureSingleRequest(CaptureRequest, IExecutor, CameraCaptureSession+CaptureCallback)	請提交由相機裝置拍攝影像的請求。 (繼承來源 CameraCaptureSession)
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
Close()	非同步關閉此擷取會話。 (繼承來源 CameraCaptureSession)
Construct(JniObjectReference, JniObjectReferenceOptions)	一個受限高速擷取會話 `CameraDevice`，用於捕捉來自 `CameraDevice` 高速影像錄製的使用場景。 (繼承來源 JavaObject)
CreateHighSpeedRequestList(CaptureRequest)	建立一個適合受限高速擷取會話串流的不可修改請求清單。
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	一個受限高速擷取會話 `CameraDevice`，用於捕捉來自 `CameraDevice` 高速影像錄製的使用場景。 (繼承來源 JavaObject)
Equals(Object)	一個受限高速擷取會話 `CameraDevice`，用於捕捉來自 `CameraDevice` 高速影像錄製的使用場景。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
FinalizeOutputConfigurations(IList<OutputConfiguration>)	最終確定輸出配置，包含延遲及/或額外曲面。 (繼承來源 CameraCaptureSession)
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
JavaFinalize()	已淘汰. 當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
Prepare(Surface)	預先分配所有緩衝區以分配輸出 Surface。 (繼承來源 CameraCaptureSession)
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	一個受限高速擷取會話 `CameraDevice`，用於捕捉來自 `CameraDevice` 高速影像錄製的使用場景。 (繼承來源 JavaObject)
SetRepeatingBurst(IList<CaptureRequest>, CameraCaptureSession+CaptureCallback, Handler)	請求在此擷取會話中無限重複擷取一連串影像。 (繼承來源 CameraCaptureSession)
SetRepeatingBurstRequests(IList<CaptureRequest>, IExecutor, CameraCaptureSession+CaptureCallback)	請求在此擷取會話中無限重複擷取一連串影像。 (繼承來源 CameraCaptureSession)
SetRepeatingRequest(CaptureRequest, CameraCaptureSession+CaptureCallback, Handler)	在此擷取階段中，請求無限重複擷取影像。 (繼承來源 CameraCaptureSession)
SetSingleRepeatingRequest(CaptureRequest, IExecutor, CameraCaptureSession+CaptureCallback)	在此擷取階段中，請求無限重複擷取影像。 (繼承來源 CameraCaptureSession)
StopRepeating()	取消任何由或 `#setRepeatingRequest setRepeatingRequest#setRepeatingBurst`設定的持續重複捕獲。 (繼承來源 CameraCaptureSession)
SupportsOfflineProcessing(Surface)	查詢某台 Surface 是否支援離線模式。 (繼承來源 CameraCaptureSession)
SwitchToOffline(ICollection<Surface>, IExecutor, CameraOfflineSession+CameraOfflineSessionCallback)	切換目前的擷取會話，指定一組註冊的攝影機表面會切換到離線處理模式。 (繼承來源 CameraCaptureSession)
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToString()	回傳物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
UpdateOutputConfiguration(OutputConfiguration)	配置完成後的更新 `OutputConfiguration` 請參見 `#finalizeOutputConfigurations`。 (繼承來源 CameraCaptureSession)
UpdateOutputConfigurations(IList<OutputConfiguration>)	更新這個攝影機會話的輸出設定。 (繼承來源 CameraCaptureSession)
Wait()	導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object)
Wait(Int64, Int32)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
Wait(Int64)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)

明確介面實作

名稱	Description
IJavaPeerable.Disposed()	一個受限高速擷取會話 `CameraDevice`，用於捕捉來自 `CameraDevice` 高速影像錄製的使用場景。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	一個受限高速擷取會話 `CameraDevice`，用於捕捉來自 `CameraDevice` 高速影像錄製的使用場景。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	一個受限高速擷取會話 `CameraDevice`，用於捕捉來自 `CameraDevice` 高速影像錄製的使用場景。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	一個受限高速擷取會話 `CameraDevice`，用於捕捉來自 `CameraDevice` 高速影像錄製的使用場景。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	一個受限高速擷取會話 `CameraDevice`，用於捕捉來自 `CameraDevice` 高速影像錄製的使用場景。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	一個受限高速擷取會話 `CameraDevice`，用於捕捉來自 `CameraDevice` 高速影像錄製的使用場景。 (繼承來源 JavaObject)
IJavaPeerable.UnregisterFromRuntime()	一個受限高速擷取會話 `CameraDevice`，用於捕捉來自 `CameraDevice` 高速影像錄製的使用場景。 (繼承來源 CameraCaptureSession)

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 `self`類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	一個受限高速擷取會話 `CameraDevice`，用於捕捉來自 `CameraDevice` 高速影像錄製的使用場景。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。

適用於