语言

Camera 类

定义

注意

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 权限。 此外,请确保包含 <使用功能> 清单元素来声明应用程序使用的相机功能。 例如,如果使用相机和自动对焦功能,清单应包括以下内容:

&lt;uses-permission android:name="android.permission.CAMERA" />
            &lt;uses-feature android:name="android.hardware.camera" />
            &lt;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
已过时.

返回此 Object的运行时类。

(继承自 Object)
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)
已过时.

除了在屏幕上显示缓冲区 #addCallbackBuffer(byte[])外,还安装要针对每个预览帧调用的回调。

SetPreviewDisplay(ISurfaceHolder)
已过时.

Surface设置要用于实时预览的项。

SetPreviewTexture(SurfaceTexture)
已过时.

SurfaceTexture设置要用于实时预览的项。

SetZoomChangeListener(Camera+IOnZoomChangeListener)
已过时.

注册一个侦听器,当缩放值在平滑缩放期间由相机驱动程序更新时通知。

StartFaceDetection()
已过时.

启动人脸检测。

StartPreview()
已过时.

开始将预览帧捕获并绘制到屏幕。

StartSmoothZoom(Int32)
已过时.

平滑缩放到请求的值。

StopFaceDetection()
已过时.

停止人脸检测。

StopPreview()
已过时.

停止捕获和绘制到图面的预览帧,并重置相机以供将来调用 #startPreview()。

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)
已过时.

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

JavaAs<TResult>(IJavaPeerable)
已过时.

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

JavaCast<TResult>(IJavaObject)
已过时.

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

JavaCast<TResult>(IJavaObject)
已过时.

Camera 类用于设置图像捕获设置、启动/停止预览、贴靠图片和检索用于视频编码的帧。

TryJavaCast<TResult>(IJavaPeerable, TResult)
已过时.

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

适用于