语言

ImageReader 类

定义

ImageReader 类允许直接应用程序访问呈现到 a android.view.Surface

[Android.Runtime.Register("android/media/ImageReader", DoNotGenerateAcw=true)]
public class ImageReader : Java.Lang.Object, IDisposable, Java.Lang.IAutoCloseable
[<Android.Runtime.Register("android/media/ImageReader", DoNotGenerateAcw=true)>]
type ImageReader = class
    inherit Object
    interface IAutoCloseable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
继承
ImageReader
特性
实现

注解

ImageReader 类允许直接应用程序访问呈现到 a android.view.Surface

多个 Android 媒体 API 类接受Surface对象作为要呈现的目标,包括MediaPlayer、MediaCodecandroid.hardware.camera2.CameraDevice和 ImageWriterandroid.renderscript.Allocation RenderScript Allocations。 可以与每个源一起使用的图像大小和格式会有所不同,并应在文档中查看特定 API。

图像数据封装在对象中 Image ,可以同时访问多个此类对象,最多可以访问构造函数参数指定的 maxImages 数字。 通过 Surface ImageReader 发送到 ImageReader 的新图像将排队,直到通过 #acquireLatestImage 或 #acquireNextImage 调用进行访问。 由于内存限制,如果 ImageReader 未获取映像并按与生产速率相等的速度释放映像,则图像源最终会停止或丢弃图像,以尝试呈现到Surface。

Java文档android.media.ImageReader。

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

构造函数

名称 说明
ImageReader(IntPtr, JniHandleOwnership)

创建 JNI 对象的托管表示形式时使用的构造函数;由运行时调用。

属性

名称 说明
Class

返回此 Object的运行时类。

(继承自 Object)
DataSpace

的默认数据空间 Image Images。

Handle

基础 Android 实例的句柄。

(继承自 Object)
HardwareBufferFormat

的默认 HardwareBuffer 格式 Image Images。

Height

默认高度 Image Images(以像素为单位)。

ImageFormat

ImageFormat image format默认值为 Image Images.

JniIdentityHashCode

获取互操作运行时分配给此Java对等的标识哈希代码。

(继承自 Object)
JniManagedPeerState

获取运行时上次分配的状态标志。

(继承自 JavaObject)
JniPeerMembers

获取用于访问此Java绑定成员的 JNI 元数据。

MaxImages

可以随时从 ImageReader 获取的最大图像数(例如,使用 #acquireNextImage)。

PeerReference

获取此Java对等方的 JNI 对象引用。

(继承自 Object)
Surface

获取可用于为此Surface生成Image Images的值ImageReader。

ThresholdClass

此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。

ThresholdType

此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。

Usage

ImageReader 可以生成的映像的使用标志。

Width

默认宽度 Image Images(以像素为单位)。

方法

名称 说明
AcquireLatestImage()

从 ImageReader 队列中获取最新 Image 消息,删除较旧的 Image images队列。

AcquireNextImage()

从 ImageReader 队列中获取下一个映像。

Clone()

创建并返回此对象的副本。

(继承自 Object)
Close()

释放与此 ImageReader 关联的所有资源。

Construct(JniObjectReference, JniObjectReferenceOptions)

将此对等方的构造委托给运行时的值管理器。

(继承自 JavaObject)
DiscardFreeBuffers()

放弃此 ImageReader 拥有的任何免费缓冲区。

Dispose()

释放此Java对等方持有的资源。

(继承自 Object)
Dispose(Boolean)

释放此Java对等方持有的资源。

(继承自 Object)
DisposeUnlessReferenced()

要求值管理器释放此对等方,除非其映射保留此相同的托管实例。

(继承自 JavaObject)
Equals(Object)

测试另一个托管对等方是否引用同一Java对象。

(继承自 JavaObject)
Equals(Object)

指示其他对象是否“等于”此对象。

(继承自 Object)
GetHashCode()

返回对象的哈希代码值。

(继承自 Object)
JavaFinalize()
已过时.

当垃圾回收确定不再引用该对象时,由对象上的垃圾回收器调用。

(继承自 Object)
NewInstance(Int32, Int32, ImageFormatType, Int32, Int64)

为所需大小、格式和使用者使用标志的图像创建新的读取器。

NewInstance(Int32, Int32, ImageFormatType, Int32)

为所需大小和格式的图像创建新的读取器。

Notify()

唤醒正在等待此对象的监视器的单个线程。

(继承自 Object)
NotifyAll()

唤醒正在等待此对象的监视器的所有线程。

(继承自 Object)
SetHandle(IntPtr, JniHandleOwnership)

设置 Handle 属性。

(继承自 Object)
SetOnImageAvailableListener(ImageReader+IOnImageAvailableListener, Handler)

注册在 ImageReader 提供新映像时要调用的侦听器。

SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

在不创建 JNI 引用副本的情况下,将引用值存储在控制块中。

(继承自 JavaObject)
ToArray<T>()

从此Java数组包装器创建托管数组。

(继承自 Object)
ToString()

返回对象的字符串表示形式。

(继承自 Object)
UnregisterFromRuntime()

从互操作运行时取消注册此Java对等。

(继承自 Object)
Wait()

导致当前线程等待,直到它被唤醒,通常是通过 通知 或 中断。

(继承自 Object)
Wait(Int64, Int32)

使当前线程等待直到唤醒,通常是通过 通知 或 中断,或直到经过一定数量的实时。

(继承自 Object)
Wait(Int64)

使当前线程等待直到唤醒,通常是通过 通知 或 中断,或直到经过一定数量的实时。

(继承自 Object)

显式接口实现

名称 说明
IJavaPeerable.Disposed()

将此对等方标记为已释放,并将disposing调用Dispose设置为 true.

(继承自 JavaObject)
IJavaPeerable.Finalized()

将此对等方标记为已释放,并将disposing调用Dispose设置为 false.

(继承自 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

获取此对等方使用的本机控制块指针。

(继承自 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

存储运行时提供的标识哈希代码。

(继承自 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

替换存储的托管对等状态标志。

(继承自 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

更新对等引用,并在引用无效时释放已释放的对等方控制块。

(继承自 JavaObject)
IJavaPeerable.UnregisterFromRuntime()

从运行时的Java对象查找中删除此实例。

扩展方法

名称 说明
GetJniTypeName(IJavaPeerable)

获取实例 self类型的 JNI 名称。

JavaAs<TResult>(IJavaPeerable)

尝试强制self键入TResult,检查强制是否在Java端有效。

JavaCast<TResult>(IJavaObject)

执行 Android 运行时检查的类型转换。

JavaCast<TResult>(IJavaObject)

重复使用兼容的托管对等,或获取请求类型的包装器。

TryJavaCast<TResult>(IJavaPeerable, TResult)

尝试强制self键入TResult,检查强制是否在Java端有效。

适用于