ImageWriter 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
ImageWriter 類別允許應用程式將影像資料產生為 android.view.Surface，並由其他元件 android.hardware.camera2.CameraDevice CameraDevice如 所使用。
[Android.Runtime.Register("android/media/ImageWriter", ApiSince=23, DoNotGenerateAcw=true)]
public class ImageWriter : Java.Lang.Object, IDisposable, Java.Lang.IAutoCloseable[<Android.Runtime.Register("android/media/ImageWriter", ApiSince=23, DoNotGenerateAcw=true)>]
type ImageWriter = class
inherit Object
interface IAutoCloseable
interface IJavaObject
interface IDisposable
interface IJavaPeerable- 繼承
- 屬性
- 實作
備註
ImageWriter 類別允許應用程式將影像資料產生為 android.view.Surface，並由其他元件 android.hardware.camera2.CameraDevice CameraDevice如 所使用。
多個 Android API 類別可以提供輸入 android.view.Surface Surface 物件，讓 ImageWriter 產生資料，包括 MediaCodec MediaCodec （編碼器）、 android.hardware.camera2.CameraCaptureSession CameraCaptureSession （重新處理輸入） ImageReader等。
輸入的影像資料被封裝在 Image 物件中。 為了將影像資料產生到目的地 android.view.Surface Surface，應用程式可以透過 #dequeueInputImage 輸入影像，然後將影像資料寫入其中。 多個此類 Image 物件可以同時被降隊，並以建構子參數指定的 maxImages 任意順序排隊回來。
如果應用程式已經有來自 ImageReader的影像，應用程式可以直接將此影像排隊至 ImageWriter（經由 #queueInputImage），且可能沒有緩衝區副本。 即使 ImageWriter 的影像格式為 ImageFormat#PRIVATE PRIVATE，且在 Android 之前，P是唯一能將影像排入此類 ImageWriter 的方法。 從 Android P 開始，私有映像檔也可透過其硬體緩衝區（如有 Image#getHardwareBuffer() ）透過此方法存取。 嘗試存取私人映像的平面時，會回傳一個空陣列。
一旦新的輸入圖片排隊進入 ImageWriter，就由下游元件（例如 ImageReader 或 android.hardware.camera2.CameraDevice）來消耗這些圖片。 如果下游元件無法以至少與 ImageWriter 產生速率 #dequeueInputImage 相同的速度消耗影像，呼叫最終會阻塞，應用程式將不得不丟棄輸入框架。
若提供輸入 android.view.Surface Surface 的消費者元件放棄 android.view.Surface Surface， #queueInputImage queueing 或 #dequeueInputImage dequeueingImage 會拋出 IllegalStateException。
Java 文件 android.media.ImageWriter。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
建構函式
| 名稱 | Description |
|---|---|
| ImageWriter(IntPtr, JniHandleOwnership) |
ImageWriter 類別允許應用程式將影像資料產生為 |
屬性
| 名稱 | Description |
|---|---|
| Class |
回傳此 |
| DataSpace |
取得 ImageWriter 的資料空間。 |
| Format |
取得 ImageWriter 格式。 |
| Handle |
底層 Android 實例的帳號。 (繼承來源 Object) |
| HardwareBufferFormat |
取得 ImageWriter 的 hardwareBuffer 格式。 |
| Height |
以像素為單位的 |
| JniIdentityHashCode |
取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object) |
| JniManagedPeerState |
ImageWriter 類別允許應用程式將影像資料產生為 |
| JniPeerMembers |
ImageWriter 類別允許應用程式將影像資料產生為 |
| MaxImages |
同時可從 ImageWriter 移除的最大影像數量（例如，為 |
| PeerReference |
取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object) |
| ThresholdClass |
ImageWriter 類別允許應用程式將影像資料產生為 |
| ThresholdType |
ImageWriter 類別允許應用程式將影像資料產生為 |
| Usage |
取得 ImageWriter 使用標記。 |
| Width |
寬度 |
方法
| 名稱 | Description |
|---|---|
| Clone() |
建立並回傳此物件的副本。 (繼承來源 Object) |
| Close() |
釋放所有與 ImageWriter 相關的資源。 |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
ImageWriter 類別允許應用程式將影像資料產生為 |
| DequeueInputImage() |
將下一個可用輸入的影像從應用程式中移除，以便產生資料。 |
| Dispose() |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| Dispose(Boolean) |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| DisposeUnlessReferenced() |
ImageWriter 類別允許應用程式將影像資料產生為 |
| Equals(Object) |
ImageWriter 類別允許應用程式將影像資料產生為 |
| Equals(Object) |
表示是否有其他物體「等同」於此物。 (繼承來源 Object) |
| GetHashCode() |
回傳物件的雜湊碼值。 (繼承來源 Object) |
| JavaFinalize() |
已淘汰.
當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object) |
| NewInstance(Surface, Int32, ImageFormatType) |
建立一個新的 ImageWriter，設定最大圖片數量和格式。 |
| NewInstance(Surface, Int32) |
建立一個新的 ImageWriter。 |
| Notify() |
喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object) |
| NotifyAll() |
喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object) |
| QueueInputImage(Image) |
將輸入 |
| SetHandle(IntPtr, JniHandleOwnership) |
設定 Handle 屬性。 (繼承來源 Object) |
| SetOnImageReleasedListener(ImageWriter+IOnImageReleasedListener, Handler) |
註冊一個監聽器，當輸入影像回傳給 ImageWriter 時，要被呼叫。 |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
ImageWriter 類別允許應用程式將影像資料產生為 |
| ToArray<T>() |
從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object) |
| ToString() |
回傳物件的字串表示。 (繼承來源 Object) |
| UnregisterFromRuntime() |
將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object) |
| Wait() |
導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object) |
| Wait(Int64, Int32) |
會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object) |
| Wait(Int64) |
會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object) |
明確介面實作
| 名稱 | Description |
|---|---|
| IJavaPeerable.Disposed() |
ImageWriter 類別允許應用程式將影像資料產生為 |
| IJavaPeerable.Finalized() |
ImageWriter 類別允許應用程式將影像資料產生為 |
| IJavaPeerable.JniObjectReferenceControlBlock |
ImageWriter 類別允許應用程式將影像資料產生為 |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
ImageWriter 類別允許應用程式將影像資料產生為 |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
ImageWriter 類別允許應用程式將影像資料產生為 |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
ImageWriter 類別允許應用程式將影像資料產生為 |
| IJavaPeerable.UnregisterFromRuntime() |
ImageWriter 類別允許應用程式將影像資料產生為 |
擴充方法
| 名稱 | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
取得實例 |
| JavaAs<TResult>(IJavaPeerable) |
試著強制 |
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時檢查型別轉換。 |
| JavaCast<TResult>(IJavaObject) |
ImageWriter 類別允許應用程式將影像資料產生為 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
試著強制 |