Camera 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
注意
This class is obsoleted in this android platform
Camera 类用于设置图像捕获设置、启动/停止预览、贴靠图片和检索用于视频编码的帧。
[Android.Runtime.Register("android/hardware/Camera", DoNotGenerateAcw=true)]
[System.Obsolete("This class is obsoleted in this android platform")]
public class Camera : Java.Lang.Object
[<Android.Runtime.Register("android/hardware/Camera", DoNotGenerateAcw=true)>]
[<System.Obsolete("This class is obsoleted in this android platform")>]
type Camera = class
inherit Object
- 继承
- 特性
注解
Camera 类用于设置图像捕获设置、启动/停止预览、贴靠图片和检索用于视频编码的帧。 此类是相机服务的客户端,用于管理实际相机硬件。
若要访问设备相机,必须在 Android 清单中声明 android.Manifest.permission#CAMERA 权限。 此外,请确保包含 <使用功能> 清单元素来声明应用程序使用的相机功能。 例如,如果使用相机和自动对焦功能,清单应包括以下内容:
<uses-permission android:name="android.permission.CAMERA" />
<uses-feature android:name="android.hardware.camera" />
<uses-feature android:name="android.hardware.camera.autofocus" />
若要使用此类拍照,请使用以下步骤:
<ol><li>从中 #open(int)获取相机的实例。
<li>Get existing (default) settings with #getParameters().
<li>如有必要,请修改返回 Camera.Parameters 的对象并调用 #setParameters(Camera.Parameters)。
<li>调用 #setDisplayOrientation(int) 以确保预览方向正确。
<li><b>重要提示</b>:将完全初始化 SurfaceHolder 的 #setPreviewDisplay(SurfaceHolder)传递给 。 如果没有表面,相机将无法启动预览。
<li><b>重要提示</b>:调用 #startPreview() 以开始更新预览图面。 必须先启动预览,然后才能拍照。
<
>如果愿意,请打电话#takePicture(Camera.ShutterCallback, Camera.PictureCallback, Camera.PictureCallback, Camera.PictureCallback)拍摄照片。 等待回调提供实际图像数据。
<拍摄>照片后,预览显示将停止。 若要拍摄更多照片,请首先再次打电话 #startPreview() 。
<li>调用 #stopPreview() 停止更新预览图面。
<li><b>Important:</b> Call #release() to release the camera for use by other applications. 应用程序应立即释放相机( android.app.Activity#onPause() 并重新#open() 输入 android.app.Activity#onResume())。
</ol>
若要快速切换到视频录制模式,请使用以下步骤:
<ol><li>获取并初始化相机并启动预览,如上所述。
<li>调用 #unlock() 以允许媒体进程访问相机。
<李>传递相机到 android.media.MediaRecorder#setCamera(Camera)。 查看 android.media.MediaRecorder 有关视频录制的信息。
<li>完成录制后,调用 #reconnect() 重新获取并重新锁定相机。
<li>如果需要,请重启预览并拍摄更多照片或视频。
<li>Call #stopPreview() and #release() as described.
</ol>
此类不是线程安全的,用于从一个事件线程使用。 大多数长时间运行的操作(预览、焦点、照片捕获等)以异步方式进行,并根据需要调用回调。 将从中调用事件线程 #open(int) 调用回调。 此类的方法绝不能同时从多个线程调用。
<强>警告:</强大的> 不同 Android 驱动的设备可能具有不同的硬件规格,例如兆像素评级和自动聚焦功能。 为了使应用程序与更多设备兼容,不应对设备相机规格做出假设。
<div class=“special reference”><h3>Developer Guides</h3>
有关使用相机的详细信息,请阅读 相机 开发人员指南。
</Div>
此成员已弃用。 建议对新应用程序使用新的 android.hardware.camera2 API。
Java文档android.hardware.Camera。
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。
构造函数
| 名称 | 说明 |
|---|---|
| Camera(IntPtr, JniHandleOwnership) |
已过时.
创建 JNI 对象的托管表示形式时使用的构造函数;由运行时调用。 |
字段
| 名称 | 说明 |
|---|---|
| ActionNewPicture |
已过时.
广播操作:相机拍摄新照片,图片条目已添加到媒体商店。 |
| ActionNewVideo |
已过时.
广播操作:相机录制新的视频,视频的条目已添加到媒体存储。 |
属性
| 名称 | 说明 |
|---|---|
| Class |
已过时.
返回此 |
| Handle |
已过时.
基础 Android 实例的句柄。 (继承自 Object) |
| JniIdentityHashCode |
已过时.
获取互操作运行时分配给此Java对等的标识哈希代码。 (继承自 Object) |
| JniManagedPeerState |
已过时.
Camera 类用于设置图像捕获设置、启动/停止预览、贴靠图片和检索用于视频编码的帧。 (继承自 JavaObject) |
| JniPeerMembers |
已过时.
获取用于访问此Java绑定成员的 JNI 元数据。 |
| NumberOfCameras |
已过时.
返回此设备上可用的物理相机数。 |
| PeerReference |
已过时.
获取此Java对等方的 JNI 对象引用。 (继承自 Object) |
| ThresholdClass |
已过时.
此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。 |
| ThresholdType |
已过时.
此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。 |
方法
| 名称 | 说明 |
|---|---|
| AddCallbackBuffer(Byte[]) |
已过时.
将预分配的缓冲区添加到预览回调缓冲区队列。 |
| AutoFocus(Camera+IAutoFocusCallback) |
已过时.
启动相机自动聚焦并注册回调函数,以在相机聚焦时运行。 |
| CancelAutoFocus() |
已过时.
取消正在进行的任何自动焦点功能。 |
| Clone() |
已过时.
创建并返回此对象的副本。 (继承自 Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
已过时.
Camera 类用于设置图像捕获设置、启动/停止预览、贴靠图片和检索用于视频编码的帧。 (继承自 JavaObject) |
| Dispose() |
已过时.
释放此Java对等方持有的资源。 (继承自 Object) |
| Dispose(Boolean) |
已过时.
释放此Java对等方持有的资源。 (继承自 Object) |
| DisposeUnlessReferenced() |
已过时.
Camera 类用于设置图像捕获设置、启动/停止预览、贴靠图片和检索用于视频编码的帧。 (继承自 JavaObject) |
| EnableShutterSound(Boolean) |
已过时.
拍摄照片时启用或禁用默认快门声音。 |
| Equals(Object) |
已过时.
Camera 类用于设置图像捕获设置、启动/停止预览、贴靠图片和检索用于视频编码的帧。 (继承自 JavaObject) |
| Equals(Object) |
已过时.
指示其他对象是否“等于”此对象。 (继承自 Object) |
| GetCameraInfo(Int32, Camera+CameraInfo) |
已过时.
返回有关特定相机的信息。 |
| GetHashCode() |
已过时.
返回对象的哈希代码值。 (继承自 Object) |
| GetParameters() |
已过时.
返回此相机服务的当前设置。 |
| JavaFinalize() |
已过时.
当垃圾回收确定不再引用该对象时,由对象上的垃圾回收器调用。 (继承自 Object) |
| Lock() |
已过时.
重新锁定相机,以防止其他进程访问它。 |
| Notify() |
已过时.
唤醒正在等待此对象的监视器的单个线程。 (继承自 Object) |
| NotifyAll() |
已过时.
唤醒正在等待此对象的监视器的所有线程。 (继承自 Object) |
| Open() |
已过时.
创建一个新的 Camera 对象,用于访问设备上的第一个面向背面的相机。 |
| Open(Int32) |
已过时.
创建新的相机对象以访问特定硬件相机。 |
| Reconnect() |
已过时.
在另一个进程使用它后重新连接到相机服务。 |
| Release() |
已过时.
断开连接并释放 Camera 对象资源。 |
| SetAutoFocusMoveCallback(Camera+IAutoFocusMoveCallback) |
已过时.
设置相机自动焦点移动回调。 |
| SetDisplayOrientation(Int32) |
已过时.
设置预览显示以度为单位的顺时针旋转。 |
| SetErrorCallback(Camera+IErrorCallback) |
已过时.
注册在发生错误时要调用的回调。 |
| SetFaceDetectionListener(Camera+IFaceDetectionListener) |
已过时.
注册一个侦听器,以通知预览帧中检测到的人脸。 |
| SetHandle(IntPtr, JniHandleOwnership) |
已过时.
设置 Handle 属性。 (继承自 Object) |
| SetOneShotPreviewCallback(Camera+IPreviewCallback) |
已过时.
除了在屏幕上显示回调外,还安装要为下一个预览帧调用的回调。 |
| SetParameters(Camera+Parameters) |
已过时.
更改此相机服务的设置。 |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
已过时.
Camera 类用于设置图像捕获设置、启动/停止预览、贴靠图片和检索用于视频编码的帧。 (继承自 JavaObject) |
| SetPreviewCallback(Camera+IPreviewCallback) |
已过时.
除了在屏幕上显示这些回调外,还安装要为每个预览帧调用的回调。 |
| SetPreviewCallbackWithBuffer(Camera+IPreviewCallback) |
已过时.
除了在屏幕上显示缓冲区 |
| SetPreviewDisplay(ISurfaceHolder) |
已过时.
|
| SetPreviewTexture(SurfaceTexture) |
已过时.
|
| SetZoomChangeListener(Camera+IOnZoomChangeListener) |
已过时.
注册一个侦听器,当缩放值在平滑缩放期间由相机驱动程序更新时通知。 |
| StartFaceDetection() |
已过时.
启动人脸检测。 |
| StartPreview() |
已过时.
开始将预览帧捕获并绘制到屏幕。 |
| StartSmoothZoom(Int32) |
已过时.
平滑缩放到请求的值。 |
| StopFaceDetection() |
已过时.
停止人脸检测。 |
| StopPreview() |
已过时.
停止捕获和绘制到图面的预览帧,并重置相机以供将来调用 |
| StopSmoothZoom() |
已过时.
停止平滑缩放。 |
| TakePicture(Camera+IShutterCallback, Camera+IPictureCallback, Camera+IPictureCallback, Camera+IPictureCallback) |
已过时.
等效于 |
| TakePicture(Camera+IShutterCallback, Camera+IPictureCallback, Camera+IPictureCallback) |
已过时.
拍照。 捕获后预览显示停止;在拍摄另一张照片之前打电话 StartPreview() 。 |
| ToArray<T>() |
已过时.
从此Java数组包装器创建托管数组。 (继承自 Object) |
| ToString() |
已过时.
返回对象的字符串表示形式。 (继承自 Object) |
| Unlock() |
已过时.
解锁相机以允许另一个进程访问它。 |
| UnregisterFromRuntime() |
已过时.
从互操作运行时取消注册此Java对等。 (继承自 Object) |
| Wait() |
已过时.
使当前线程等待,直到唤醒它,通常是通过 em 通知/em< 或 >em<interrupted>/em<。><> (继承自 Object) |
| Wait(Int64, Int32) |
已过时.
使当前线程等待直到唤醒,通常是通过 <em>通知</em> 或 <em interrupted>/em<>,或直到经过一定数量的实时。 (继承自 Object) |
| Wait(Int64) |
已过时.
使当前线程等待直到唤醒,通常是通过 <em>通知</em> 或 <em interrupted>/em<>,或直到经过一定数量的实时。 (继承自 Object) |
事件
| 名称 | 说明 |
|---|---|
| FaceDetection |
已过时.
在相机预览帧中检测到人脸时发生。 |
| ZoomChange |
已过时.
缩放值在平滑缩放操作期间发生更改时发生。 |
显式接口实现
| 名称 | 说明 |
|---|---|
| IJavaPeerable.Disposed() |
已过时.
Camera 类用于设置图像捕获设置、启动/停止预览、贴靠图片和检索用于视频编码的帧。 (继承自 JavaObject) |
| IJavaPeerable.Finalized() |
已过时.
Camera 类用于设置图像捕获设置、启动/停止预览、贴靠图片和检索用于视频编码的帧。 (继承自 JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
已过时.
Camera 类用于设置图像捕获设置、启动/停止预览、贴靠图片和检索用于视频编码的帧。 (继承自 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
已过时.
Camera 类用于设置图像捕获设置、启动/停止预览、贴靠图片和检索用于视频编码的帧。 (继承自 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
已过时.
Camera 类用于设置图像捕获设置、启动/停止预览、贴靠图片和检索用于视频编码的帧。 (继承自 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
已过时.
Camera 类用于设置图像捕获设置、启动/停止预览、贴靠图片和检索用于视频编码的帧。 (继承自 JavaObject) |
扩展方法
| 名称 | 说明 |
|---|---|
| GetJniTypeName(IJavaPeerable) |
已过时.
获取实例 |
| JavaAs<TResult>(IJavaPeerable) |
已过时.
尝试强制 |
| JavaCast<TResult>(IJavaObject) |
已过时.
执行 Android 运行时检查的类型转换。 |
| JavaCast<TResult>(IJavaObject) |
已过时.
Camera 类用于设置图像捕获设置、启动/停止预览、贴靠图片和检索用于视频编码的帧。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
已过时.
尝试强制 |