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

繼承

Object

JavaObject

Object

Camera

屬性

RegisterAttribute ObsoleteAttribute

備註

相機類別用於設定影像擷取設定、開始/停止預覽、拍攝照片，以及擷取影格以編碼影片。 此類別是 Camera 服務的客戶端，負責管理實際的相機硬體。

要存取裝置相機，必須在 Android 清單中宣告權限。android.Manifest.permission#CAMERA 同時也務必包含 <uses-feature> 清單元素，以宣告應用程式使用的相機功能。 例如，如果您使用相機與自動對焦功能，您的清單應包含以下內容：

<uses-permission android:name="android.permission.CAMERA" />
            <uses-feature android:name="android.hardware.camera" />
            <uses-feature android:name="android.hardware.camera.autofocus" />

要與這堂課拍照，請使用以下步驟：

<ol><li>從 取得 Camera #open(int)的實例。

<li>取得現有（預設）設定。#getParameters()

<如>有必要，修改回傳物件 Camera.Parameters 並呼叫 #setParameters(Camera.Parameters)。

< >請致電#setDisplayOrientation(int)以確保預覽的正確方向。

<li><b>重要</b>：將 a 完全初始 SurfaceHolder 化為 #setPreviewDisplay(SurfaceHolder)。 沒有表面，攝影機將無法啟動預覽。

<li><b>重要</b>：請致電 #startPreview() 開始更新預覽表面。 預覽必須先開始，才能拍照。

<李>，想拍照的時候打電話 #takePicture(Camera.ShutterCallback, Camera.PictureCallback, Camera.PictureCallback, Camera.PictureCallback) 。 等回調提供實際的影像資料。

<李>拍照後，預覽顯示會停止。 想拍更多照片，請先再打電話 #startPreview() 。

<李>，打電話 #stopPreview() 停止更新預覽表面。

<li><b>重要：</b> 呼叫 #release() 釋放相機供其他應用程式使用。 應用程式應該會立即 android.app.Activity#onPause() 釋放攝影機（並重新放#open() 回 android.app.Activity#onResume()）。 </ol>

要快速切換到錄影模式，請使用以下步驟：

< > <ol li>取得並初始化相機，並如上所述開始預覽。

< >打電話#unlock()讓媒體進程進入攝影機。

<李>，把相機交給 android.media.MediaRecorder#setCamera(Camera)。 請參閱 android.media.MediaRecorder 有關錄影的資訊。

<李>錄影結束後，打電話 #reconnect() 重新取得並鎖定攝影機。

<如果>需要，可以重新啟動預覽並拍攝更多照片或影片。

<如上所述，李>考爾#stopPreview()#release()。 </ol>

此類別並非執行緒安全，設計用於單一事件執行緒。 大多數長期執行的操作（預覽、對焦、拍照等）都是非同步進行，並視需要呼叫回調。 回調會在呼叫執行緒的事件執行緒 #open(int) 中被調用。 此類別的方法絕不能同時從多個執行緒呼叫。

<強烈>注意：</strong> 不同的 Android 裝置可能有不同的硬體規格，例如百萬像素和自動對焦功能。 為了讓你的應用程式能與更多裝置相容，你不應該對裝置攝影機的規格做出假設。

<div class=“特殊參考”><h3>開發者指南</h3>

想了解更多相機使用資訊，請閱讀 相機 開發指南。

</div>

此會員已被棄用。 我們建議新應用程式使用新的 android.hardware.camera2 API。

Java 文件 android.hardware.Camera。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。