OutputConfiguration 建構函式
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| OutputConfiguration(Surface) |
建立 |
| OutputConfiguration(ImageFormatType, Size) |
為某個格式和大小建立一個新 |
| OutputConfiguration(Size, Class) |
建立一個新的 |
| OutputConfiguration(Int32, Surface) |
建立 |
| OutputConfiguration(ImageFormatType, Size, Int64) |
為特定格式、大小和使用標誌建立一個新 |
| OutputConfiguration(Int32, ImageFormatType, Size) |
為 一個 |
| OutputConfiguration(Int32, ImageFormatType, Size, Int64) |
為給定的 surface group ID、格式、大小和使用標誌建立一個新 |
OutputConfiguration(Surface)
建立 OutputConfiguration 一個新的實例，包含 Surface。
[Android.Runtime.Register(".ctor", "(Landroid/view/Surface;)V", "", ApiSince=24)]
public OutputConfiguration(Android.Views.Surface surface);[<Android.Runtime.Register(".ctor", "(Landroid/view/Surface;)V", "", ApiSince=24)>]
new Android.Hardware.Camera2.Params.OutputConfiguration : Android.Views.Surface -> Android.Hardware.Camera2.Params.OutputConfiguration參數
- surface
- Surface
一個用來輸出攝影機的 Surface。
<p>This constructor creates a default configuration, with a surface group ID of
<code data-dev-comment-type="c">#SURFACE_GROUP_ID_NONE</code>.</p>
- 屬性
備註
建立 OutputConfiguration 一個新的實例，包含 Surface。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
OutputConfiguration(ImageFormatType, Size)
為某個格式和大小建立一個新 OutputConfiguration 實例 ImageReader 。
[Android.Runtime.Register(".ctor", "(ILandroid/util/Size;)V", "", ApiSince=35)]
public OutputConfiguration(Android.Graphics.ImageFormatType format, Android.Util.Size surfaceSize);[<Android.Runtime.Register(".ctor", "(ILandroid/util/Size;)V", "", ApiSince=35)>]
new Android.Hardware.Camera2.Params.OutputConfiguration : Android.Graphics.ImageFormatType * Android.Util.Size -> Android.Hardware.Camera2.Params.OutputConfiguration參數
- format
- ImageFormatType
ImageReader 輸出的格式。 這必須是 android.graphics.ImageFormat 其中一個或 android.graphics.PixelFormat 常數。 請注意，並非所有格式都被相機裝置支援。
- surfaceSize
- Size
ImageReader 表面的尺寸。
- 屬性
備註
為某個格式和大小建立一個新 OutputConfiguration 實例 ImageReader 。
此建構子為 ImageReader 建立 OutputConfiguration，但不提供實際輸出 Surface。 實際輸出 Surface 必須先設定#addSurface好，才能建立擷取會話。
由此建構子建立的 OutputConfiguration 物件可用於 android.hardware.camera2.CameraDevice.CameraDeviceSetup#isSessionConfigurationSupported ， android.hardware.camera2.CameraDevice.CameraDeviceSetup#getSessionCharacteristics 且無需呼叫 #addSurface。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
OutputConfiguration(Size, Class)
建立一個新的OutputConfiguration實例，使用所需的 Surface 大小和 Surface 來源類別。
[Android.Runtime.Register(".ctor", "(Landroid/util/Size;Ljava/lang/Class;)V", "", ApiSince=26)]
public OutputConfiguration(Android.Util.Size surfaceSize, Java.Lang.Class klass);[<Android.Runtime.Register(".ctor", "(Landroid/util/Size;Ljava/lang/Class;)V", "", ApiSince=26)>]
new Android.Hardware.Camera2.Params.OutputConfiguration : Android.Util.Size * Java.Lang.Class -> Android.Hardware.Camera2.Params.OutputConfiguration參數
- surfaceSize
- Size
延後曲面的尺寸。
- klass
- Class
一個非nullClass 物件的參考，指示該表面的來源。 只有 android.view.SurfaceHolder SurfaceHolder.class、 android.graphics.SurfaceTexture SurfaceTexture.class、 android.media.MediaRecorder MediaRecorder.class、 android.media.MediaCodec MediaCodec.class 支援。
在 android.os.Build.VERSION_CODES#VANILLA_ICE_CREAM Android V之前，只有 android.view.SurfaceHolder SurfaceHolder.class 和 android.graphics.SurfaceTexture SurfaceTexture.class 才被支援。
- 屬性
備註
建立一個新的OutputConfiguration實例，使用所需的 Surface 大小和 Surface 來源類別。
此建構器會取得期望的 Surface 大小與 Surface 原始類別的參數，但未提供實際輸出的 Surface。 此用來設定帶有延遲 Surface 的輸出配置。 應用程式可以使用此輸出設定來建立會話。
從 開始android.os.Build.VERSION_CODES#VANILLA_ICE_CREAM Android V，延遲 Surface 可由 得到：（1） 透過android.view.SurfaceView呼叫 android.view.SurfaceHolder#getSurface，（2） 由 android.view.Surface#Surface(android.graphics.SurfaceTexture)android.graphics.SurfaceTexture via 得到，（3） 由 android.media.MediaRecorder via android.media.MediaRecorder#getSurface 或 android.media.MediaCodec#createPersistentInputSurface，或 （4） 由 android.media.MediaCodec via android.media.MediaCodec#createInputSurface 或 android.media.MediaCodec#createPersistentInputSurface得到。
<ul>li 曲面 和 android.graphics.SurfaceTextureandroid.view.SurfaceView 可以延後到 之後CameraDevice#createCaptureSession。>< 此時，輸出 Surface 必須透過 #addSurface設定，且 必須CameraCaptureSession#finalizeOutputConfigurations先透過 完成 Surface 配置，然後再向 Surface 目標提交請求。</li><li>對於所有其他目標類型，輸出 Surface 必須由 #addSurface設定，且CameraCaptureSession#finalizeOutputConfigurations不需要，因為用於建立會話的 OutputConfiguration 會包含實際的 Surface。</li></ul>
在 android.os.Build.VERSION_CODES#VANILLA_ICE_CREAM Android V之前，只有 android.view.SurfaceView 和 android.graphics.SurfaceTexture 才被支援。 這兩種輸出都可以延後到之後 CameraDevice#createCaptureSessionByOutputConfigurations。
由此建構子建立的 OutputConfiguration 物件可用於 android.hardware.camera2.CameraDevice.CameraDeviceSetup#isSessionConfigurationSupported ， android.hardware.camera2.CameraDevice.CameraDeviceSetup#getSessionCharacteristics 且無需呼叫 #addSurface。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
OutputConfiguration(Int32, Surface)
建立OutputConfiguration一個帶有 Surface、surface group ID 的新實例。
[Android.Runtime.Register(".ctor", "(ILandroid/view/Surface;)V", "", ApiSince=24)]
public OutputConfiguration(int surfaceGroupId, Android.Views.Surface surface);[<Android.Runtime.Register(".ctor", "(ILandroid/view/Surface;)V", "", ApiSince=24)>]
new Android.Hardware.Camera2.Params.OutputConfiguration : int * Android.Views.Surface -> Android.Hardware.Camera2.Params.OutputConfiguration參數
- surfaceGroupId
- Int32
此輸出的群組 ID，用於多個輸出間的記憶體共享。
- surface
- Surface
一個用來輸出攝影機的 Surface。
- 屬性
備註
建立OutputConfiguration一個帶有 Surface、surface group ID 的新實例。
曲面群組 ID 用於識別該輸出曲面所屬的曲面群組。 表面群組是一組不打算同時接收攝影機輸出緩衝區串流的輸出表面。 他們 CameraDevice 可能能夠共享同一表面群組中所有表面所使用的緩衝區，從而減少整體記憶體佔用。 應用程式應該只為未同時串流的串流設定相同的 ID。 若為負ID，則表示該曲面不屬於任何曲面群。 預設值為 #SURFACE_GROUP_ID_NONE。
例如，一個具備自適應輸出解析度功能的視訊聊天應用程式，需要兩個（或更多）輸出解析度，才能在不出現輸出故障的情況下切換解析度。 然而，在任何時刻，只有一個輸出是啟用的，以減少外出網路頻寬和編碼負擔。 為了節省記憶體，應用程式應將視訊輸出設定為相同的非負群組 ID，讓攝影機裝置能共用相同的記憶體區域以供交替輸出使用。
在同一擷取請求中包含相同群組 ID 的輸出串流並非錯誤，但若兩串流不在同一表面群組，且輸出尺寸差異顯著，記憶體消耗可能更高。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
OutputConfiguration(ImageFormatType, Size, Int64)
為特定格式、大小和使用標誌建立一個新 OutputConfiguration 實例 ImageReader 。
[Android.Runtime.Register(".ctor", "(ILandroid/util/Size;J)V", "", ApiSince=35)]
public OutputConfiguration(Android.Graphics.ImageFormatType format, Android.Util.Size surfaceSize, long usage);[<Android.Runtime.Register(".ctor", "(ILandroid/util/Size;J)V", "", ApiSince=35)>]
new Android.Hardware.Camera2.Params.OutputConfiguration : Android.Graphics.ImageFormatType * Android.Util.Size * int64 -> Android.Hardware.Camera2.Params.OutputConfiguration參數
- format
- ImageFormatType
ImageReader 輸出的格式。 這必須是 android.graphics.ImageFormat 其中一個或 android.graphics.PixelFormat 常數。 請注意，並非所有格式都被相機裝置支援。
- surfaceSize
- Size
ImageReader 表面的尺寸。
- usage
- Int64
ImageReader 輸出的使用標誌會顯示。
- 屬性
備註
為特定格式、大小和使用標誌建立一個新 OutputConfiguration 實例 ImageReader 。
此建構子為 ImageReader 建立 OutputConfiguration，但不提供實際輸出 Surface。 實際輸出 Surface 必須先設定#addSurface好，才能建立擷取會話。
由此建構子建立的 OutputConfiguration 物件可用於 android.hardware.camera2.CameraDevice.CameraDeviceSetup#isSessionConfigurationSupported ， android.hardware.camera2.CameraDevice.CameraDeviceSetup#getSessionCharacteristics 且無需呼叫 #addSurface。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
OutputConfiguration(Int32, ImageFormatType, Size)
為 一個ImageReader新的OutputConfiguration實例，針對特定的 surfaceGroupId、格式和大小。
[Android.Runtime.Register(".ctor", "(IILandroid/util/Size;)V", "", ApiSince=35)]
public OutputConfiguration(int surfaceGroupId, Android.Graphics.ImageFormatType format, Android.Util.Size surfaceSize);[<Android.Runtime.Register(".ctor", "(IILandroid/util/Size;)V", "", ApiSince=35)>]
new Android.Hardware.Camera2.Params.OutputConfiguration : int * Android.Graphics.ImageFormatType * Android.Util.Size -> Android.Hardware.Camera2.Params.OutputConfiguration參數
- surfaceGroupId
- Int32
此輸出的群組 ID，用於多個輸出間的記憶體共享。
- format
- ImageFormatType
ImageReader 輸出的格式。 這必須是 android.graphics.ImageFormat 其中一個或 android.graphics.PixelFormat 常數。 請注意，並非所有格式都被相機裝置支援。
- surfaceSize
- Size
ImageReader 表面的尺寸。
- 屬性
備註
為 一個ImageReader新的OutputConfiguration實例，針對特定的 surfaceGroupId、格式和大小。
此建構子為 ImageReader 建立 OutputConfiguration，但不提供實際輸出 Surface。 實際輸出 Surface 必須先設定#addSurface好，才能建立擷取會話。
由此建構子建立的 OutputConfiguration 物件可用於 android.hardware.camera2.CameraDevice.CameraDeviceSetup#isSessionConfigurationSupported ， android.hardware.camera2.CameraDevice.CameraDeviceSetup#getSessionCharacteristics 且無需呼叫 #addSurface。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
OutputConfiguration(Int32, ImageFormatType, Size, Int64)
為給定的 surface group ID、格式、大小和使用標誌建立一個新 OutputConfiguration 實例 ImageReader 。
[Android.Runtime.Register(".ctor", "(IILandroid/util/Size;J)V", "", ApiSince=35)]
public OutputConfiguration(int surfaceGroupId, Android.Graphics.ImageFormatType format, Android.Util.Size surfaceSize, long usage);[<Android.Runtime.Register(".ctor", "(IILandroid/util/Size;J)V", "", ApiSince=35)>]
new Android.Hardware.Camera2.Params.OutputConfiguration : int * Android.Graphics.ImageFormatType * Android.Util.Size * int64 -> Android.Hardware.Camera2.Params.OutputConfiguration參數
- surfaceGroupId
- Int32
此輸出的群組 ID，用於多個輸出間的記憶體共享。
- format
- ImageFormatType
ImageReader 輸出的格式。 這必須是 android.graphics.ImageFormat 其中一個或 android.graphics.PixelFormat 常數。 請注意，並非所有格式都被相機裝置支援。
- surfaceSize
- Size
ImageReader 表面的尺寸。
- usage
- Int64
ImageReader 輸出的使用標誌會顯示。
- 屬性
備註
為給定的 surface group ID、格式、大小和使用標誌建立一個新 OutputConfiguration 實例 ImageReader 。
此建構子為 ImageReader 建立 OutputConfiguration，但不提供實際輸出 Surface。 實際輸出 Surface 必須先設定#addSurface好，才能建立擷取會話。
由此建構子建立的 OutputConfiguration 物件可用於 android.hardware.camera2.CameraDevice.CameraDeviceSetup#isSessionConfigurationSupported ， android.hardware.camera2.CameraDevice.CameraDeviceSetup#getSessionCharacteristics 且無需呼叫 #addSurface。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。