Trang này đề cập đến lớp Camera (không dùng nữa). Bạn nên dùng CameraX hoặc Camera2 (trong một số trường hợp sử dụng cụ thể). Cả CameraX và Camera2 đều hỗ trợ Android 5.0 (cấp độ API 21) trở lên.
Để tìm hiểu cách di chuyển từ Camera1 sang CameraX, hãy xem bài viết Di chuyển Camera1 sang CameraX. Ngoài ra, bạn có thể sử dụng kỹ năng tác nhân để di chuyển từ Camera1 sang CameraX.
Khung Android hỗ trợ nhiều loại máy ảnh và tính năng máy ảnh có trên thiết bị, cho phép bạn chụp ảnh và quay video trong ứng dụng. Tài liệu này thảo luận về một phương pháp nhanh chóng, đơn giản để chụp ảnh và quay video, đồng thời trình bày một phương pháp nâng cao để tạo trải nghiệm máy ảnh tuỳ chỉnh cho người dùng.
Hãy tham khảo các tài nguyên có liên quan sau đây:
Những yếu tố nên cân nhắc
Trước khi cho phép ứng dụng sử dụng camera trên thiết bị Android, bạn nên cân nhắc một vài câu hỏi về cách ứng dụng dự định sử dụng tính năng phần cứng này.
Yêu cầu về máy ảnh – Việc sử dụng máy ảnh có quan trọng đến mức bạn không muốn cài đặt ứng dụng của mình trên thiết bị không có máy ảnh không? Nếu có, bạn nên khai báo yêu cầu về camera trong tệp kê khai.
Chụp ảnh nhanh hoặc Máy ảnh tuỳ chỉnh – Ứng dụng của bạn sẽ sử dụng máy ảnh như thế nào? Bạn chỉ muốn chụp ảnh hoặc quay đoạn video nhanh hay ứng dụng của bạn sẽ cung cấp một cách mới để sử dụng máy ảnh? Để chụp nhanh hoặc quay nhanh, hãy cân nhắc Sử dụng ứng dụng máy ảnh hiện có. Để phát triển một tính năng máy ảnh tuỳ chỉnh, hãy xem phần Xây dựng ứng dụng máy ảnh.
Yêu cầu đối với dịch vụ nền trước – Ứng dụng của bạn tương tác với camera khi nào? Trên Android 9 (cấp độ API 28) trở lên, các ứng dụng chạy trong nền không thể truy cập vào camera. Do đó, bạn nên sử dụng camera khi ứng dụng đang chạy ở nền trước hoặc trong một dịch vụ nền trước.
Bộ nhớ – Hình ảnh hoặc video mà ứng dụng của bạn tạo ra chỉ hiển thị với ứng dụng của bạn hay được chia sẻ để các ứng dụng khác như Thư viện hoặc các ứng dụng mạng xã hội và nội dung nghe nhìn khác có thể sử dụng? Bạn có muốn ảnh và video vẫn còn ngay cả khi ứng dụng của bạn bị gỡ cài đặt không? Hãy xem phần Lưu tệp nội dung nghe nhìn để biết cách triển khai các lựa chọn này.
Thông tin cơ bản
Khung Android hỗ trợ chụp ảnh và quay video thông qua API android.hardware.camera2 hoặc Intent của máy ảnh. Dưới đây là các lớp có liên quan:
android.hardware.camera2- Gói này là API chính để điều khiển camera của thiết bị. Bạn có thể dùng lớp này để chụp ảnh hoặc quay video khi tạo ứng dụng máy ảnh.
Camera- Lớp này là API cũ hơn, không còn được dùng nữa để điều khiển camera của thiết bị.
SurfaceView- Lớp này dùng để hiển thị bản xem trước trực tiếp của camera cho người dùng.
MediaRecorder- Lớp này được dùng để quay video từ camera.
Intent- Bạn có thể dùng loại thao tác theo ý định
MediaStore.ACTION_IMAGE_CAPTUREhoặcMediaStore.ACTION_VIDEO_CAPTUREđể chụp ảnh hoặc quay video mà không cần trực tiếp sử dụng đối tượngCamera.
Nội dung khai báo trong tệp kê khai
Trước khi bắt đầu phát triển ứng dụng bằng API Máy ảnh, bạn nên đảm bảo tệp kê khai có các nội dung khai báo thích hợp để cho phép sử dụng phần cứng máy ảnh và các tính năng liên quan khác.
Quyền truy cập camera – Ứng dụng của bạn phải yêu cầu quyền sử dụng camera của thiết bị.
<uses-permission android:name="android.permission.CAMERA" />Tính năng máy ảnh – Ứng dụng của bạn cũng phải khai báo việc sử dụng các tính năng máy ảnh, ví dụ:
<uses-feature android:name="android.hardware.camera" />Để biết danh sách các tính năng của máy ảnh, hãy xem Tài liệu tham khảo về tính năng của tệp kê khai.
Việc thêm các tính năng của camera vào tệp kê khai sẽ khiến Google Play ngăn ứng dụng của bạn cài đặt vào các thiết bị không có camera hoặc không hỗ trợ các tính năng của camera mà bạn chỉ định. Để biết thêm thông tin về cách sử dụng cơ chế lọc dựa trên tính năng với Google Play, hãy xem bài viết Google Play và cơ chế lọc dựa trên tính năng.
Nếu ứng dụng của bạn có thể dùng máy ảnh hoặc tính năng máy ảnh để hoạt động đúng cách nhưng không bắt buộc phải có, thì bạn nên chỉ định điều này trong tệp kê khai bằng cách thêm thuộc tính
android:requiredvà đặt thuộc tính này thànhfalse:<uses-feature android:name="android.hardware.camera" android:required="false" />Quyền truy cập vào bộ nhớ – Ứng dụng của bạn có thể lưu hình ảnh hoặc video vào bộ nhớ ngoài của thiết bị (Thẻ SD) nếu ứng dụng nhắm đến Android 10 (cấp độ API 29) trở xuống và chỉ định những thông tin sau trong tệp kê khai.
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />Quyền ghi âm – Để ghi âm khi quay video, ứng dụng của bạn phải yêu cầu quyền ghi âm.
<uses-permission android:name="android.permission.RECORD_AUDIO" />Quyền truy cập vị trí – Nếu ứng dụng của bạn gắn thẻ hình ảnh bằng thông tin vị trí GPS, thì bạn phải yêu cầu quyền
ACCESS_FINE_LOCATION. Lưu ý rằng nếu ứng dụng của bạn nhắm đến Android 5.0 (cấp độ API 21) trở lên, thì bạn cũng cần khai báo rằng ứng dụng của bạn sử dụng GPS của thiết bị:<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> ... <!-- Needed only if your app targets Android 5.0 (API level 21) or higher. --> <uses-feature android:name="android.hardware.location.gps" />Để biết thêm thông tin về cách lấy thông tin vị trí của người dùng, hãy xem bài viết Chiến lược vị trí.
Sử dụng các ứng dụng camera hiện có
Cách nhanh chóng để cho phép chụp ảnh hoặc quay video trong ứng dụng mà không cần nhiều mã bổ sung là sử dụng Intent để gọi một ứng dụng máy ảnh Android hiện có.
Thông tin chi tiết được mô tả trong các bài học đào tạo Chụp ảnh đơn giản và Quay video đơn giản.
Tạo ứng dụng máy ảnh
Một số nhà phát triển có thể yêu cầu giao diện người dùng của máy ảnh được tuỳ chỉnh theo giao diện của ứng dụng hoặc cung cấp các tính năng đặc biệt. Việc viết mã chụp ảnh của riêng bạn có thể mang lại trải nghiệm hấp dẫn hơn cho người dùng.
Lưu ý: Hướng dẫn sau đây là dành cho API Camera cũ, không còn được dùng nữa. Đối với các ứng dụng máy ảnh mới hoặc nâng cao, bạn nên dùng API android.hardware.camera2 mới hơn.
Các bước chung để tạo giao diện máy ảnh tuỳ chỉnh cho ứng dụng như sau:
- Phát hiện và truy cập vào camera – Tạo mã để kiểm tra xem có camera hay không và yêu cầu quyền truy cập.
- Tạo lớp xem trước – Tạo lớp xem trước của camera giúp mở rộng
SurfaceViewvà triển khai giao diệnSurfaceHolder. Lớp này xem trước hình ảnh trực tiếp từ camera. - Tạo bố cục xem trước – Sau khi có lớp xem trước của camera, hãy tạo một bố cục chế độ xem kết hợp bản xem trước và các thành phần điều khiển giao diện người dùng mà bạn muốn.
- Thiết lập trình nghe để chụp – Kết nối trình nghe cho các chế độ điều khiển giao diện để bắt đầu chụp ảnh hoặc quay video nhằm phản hồi các thao tác của người dùng, chẳng hạn như nhấn nút.
- Chụp và lưu tệp – Thiết lập mã để chụp ảnh hoặc quay video và lưu kết quả.
- Giải phóng máy ảnh – Sau khi sử dụng máy ảnh, ứng dụng của bạn phải giải phóng máy ảnh đúng cách để các ứng dụng khác sử dụng.
Phần cứng máy ảnh là một tài nguyên dùng chung phải được quản lý cẩn thận để ứng dụng của bạn không xung đột với các ứng dụng khác cũng có thể muốn sử dụng tài nguyên này. Các phần sau đây thảo luận về cách phát hiện phần cứng camera, cách yêu cầu quyền truy cập vào camera, cách chụp ảnh hoặc quay video và cách giải phóng camera khi ứng dụng của bạn dùng xong.
Đang phát hiện phần cứng camera
Nếu ứng dụng của bạn không yêu cầu cụ thể máy ảnh bằng cách khai báo tệp kê khai, bạn nên kiểm tra xem máy ảnh có sẵn trong thời gian chạy hay không. Để thực hiện quy trình kiểm tra này, hãy sử dụng phương thức PackageManager.hasSystemFeature(), như trong mã ví dụ dưới đây:
Kotlin
/** Check if this device has a camera */
private fun checkCameraHardware(context: Context): Boolean {
if (context.packageManager.hasSystemFeature(PackageManager.FEATURE_CAMERA)) {
// this device has a camera
return true
} else {
// no camera on this device
return false
}
}
Java
/** Check if this device has a camera */
private boolean checkCameraHardware(Context context) {
if (context.getPackageManager().hasSystemFeature(PackageManager.FEATURE_CAMERA)){
// this device has a camera
return true;
} else {
// no camera on this device
return false;
}
}
Thiết bị Android có thể có nhiều camera, chẳng hạn như camera sau để chụp ảnh và camera trước để gọi video. Android 2.3 (API cấp 9) trở lên cho phép bạn kiểm tra số lượng máy ảnh có trên thiết bị bằng phương thức Camera.getNumberOfCameras().
Truy cập vào camera
Nếu đã xác định rằng thiết bị mà ứng dụng của bạn đang chạy có camera, thì bạn phải yêu cầu quyền truy cập vào camera bằng cách lấy một thực thể của Camera (trừ phi bạn đang sử dụng ý định truy cập vào camera).
Để truy cập vào camera chính, hãy sử dụng phương thức Camera.open() và nhớ nắm bắt mọi trường hợp ngoại lệ, như trong mã dưới đây:
Kotlin
/** A safe way to get an instance of the Camera object. */
fun getCameraInstance(): Camera? {
return try {
Camera.open() // attempt to get a Camera instance
} catch (e: Exception) {
// Camera is not available (in use or does not exist)
null // returns null if camera is unavailable
}
}
Java
/** A safe way to get an instance of the Camera object. */
public static Camera getCameraInstance(){
Camera c = null;
try {
c = Camera.open(); // attempt to get a Camera instance
}
catch (Exception e){
// Camera is not available (in use or does not exist)
}
return c; // returns null if camera is unavailable
}
Trên các thiết bị chạy Android 2.3 (cấp độ API 9) trở lên, bạn có thể truy cập vào các camera cụ thể bằng cách sử dụng Camera.open(int). Đoạn mã ví dụ ở trên sẽ truy cập vào máy ảnh mặt sau đầu tiên trên thiết bị có nhiều máy ảnh.
Kiểm tra các tính năng của camera
Sau khi có quyền truy cập vào camera, bạn có thể xem thêm thông tin về các chức năng của camera bằng cách sử dụng phương thức Camera.getParameters() và kiểm tra đối tượng Camera.Parameters được trả về để biết các chức năng được hỗ trợ. Khi sử dụng cấp độ API 9 trở lên, hãy dùng Camera.getCameraInfo() để xác định xem Máy ảnh nằm ở mặt trước hay mặt sau của Thiết bị và hướng của hình ảnh.
Tạo lớp xem trước
Để người dùng chụp ảnh hoặc quay video một cách hiệu quả, họ phải xem được những gì camera của thiết bị
nhìn thấy. Lớp xem trước camera là một SurfaceView có thể hiển thị dữ liệu hình ảnh trực tiếp từ camera, nhờ đó người dùng có thể tạo khung hình và chụp ảnh hoặc quay video.
Mã ví dụ sau đây minh hoạ cách tạo một lớp xem trước camera cơ bản có thể đưa vào bố cục View. Lớp này triển khai SurfaceHolder.Callback để ghi lại các sự kiện gọi lại nhằm tạo và huỷ khung hiển thị, cần thiết cho việc chỉ định đầu vào xem trước của máy ảnh.
Kotlin
/** A basic Camera preview class */
class CameraPreview(
context: Context,
private val mCamera: Camera
) : SurfaceView(context), SurfaceHolder.Callback {
private val mHolder: SurfaceHolder = holder.apply {
// Install a SurfaceHolder.Callback so we get notified when the
// underlying surface is created and destroyed.
addCallback(this@CameraPreview)
// deprecated setting, but required on Android versions prior to 3.0
setType(SurfaceHolder.SURFACE_TYPE_PUSH_BUFFERS)
}
override fun surfaceCreated(holder: SurfaceHolder) {
// The Surface has been created, now tell the camera where to draw the preview.
mCamera.apply {
try {
setPreviewDisplay(holder)
startPreview()
} catch (e: IOException) {
Log.d(TAG, "Error setting camera preview: ${e.message}")
}
}
}
override fun surfaceDestroyed(holder: SurfaceHolder) {
// empty. Take care of releasing the Camera preview in your activity.
}
override fun surfaceChanged(holder: SurfaceHolder, format: Int, w: Int, h: Int) {
// If your preview can change or rotate, take care of those events here.
// Make sure to stop the preview before resizing or reformatting it.
if (mHolder.surface == null) {
// preview surface does not exist
return
}
// stop preview before making changes
try {
mCamera.stopPreview()
} catch (e: Exception) {
// ignore: tried to stop a non-existent preview
}
// set preview size and make any resize, rotate or
// reformatting changes here
// start preview with new settings
mCamera.apply {
try {
setPreviewDisplay(mHolder)
startPreview()
} catch (e: Exception) {
Log.d(TAG, "Error starting camera preview: ${e.message}")
}
}
}
}
Java
/** A basic Camera preview class */
public class CameraPreview extends SurfaceView implements SurfaceHolder.Callback {
private SurfaceHolder mHolder;
private Camera mCamera;
public CameraPreview(Context context, Camera camera) {
super(context);
mCamera = camera;
// Install a SurfaceHolder.Callback so we get notified when the
// underlying surface is created and destroyed.
mHolder = getHolder();
mHolder.addCallback(this);
// deprecated setting, but required on Android versions prior to 3.0
mHolder.setType(SurfaceHolder.SURFACE_TYPE_PUSH_BUFFERS);
}
public void surfaceCreated(SurfaceHolder holder) {
// The Surface has been created, now tell the camera where to draw the preview.
try {
mCamera.setPreviewDisplay(holder);
mCamera.startPreview();
} catch (IOException e) {
Log.d(TAG, "Error setting camera preview: " + e.getMessage());
}
}
public void surfaceDestroyed(SurfaceHolder holder) {
// empty. Take care of releasing the Camera preview in your activity.
}
public void surfaceChanged(SurfaceHolder holder, int format, int w, int h) {
// If your preview can change or rotate, take care of those events here.
// Make sure to stop the preview before resizing or reformatting it.
if (mHolder.getSurface() == null){
// preview surface does not exist
return;
}
// stop preview before making changes
try {
mCamera.stopPreview();
} catch (Exception e){
// ignore: tried to stop a non-existent preview
}
// set preview size and make any resize, rotate or
// reformatting changes here
// start preview with new settings
try {
mCamera.setPreviewDisplay(mHolder);
mCamera.startPreview();
} catch (Exception e){
Log.d(TAG, "Error starting camera preview: " + e.getMessage());
}
}
}
Nếu bạn muốn đặt kích thước cụ thể cho bản xem trước của máy ảnh, hãy đặt kích thước này trong phương thức surfaceChanged() như đã lưu ý trong các nhận xét ở trên. Khi đặt kích thước bản xem trước, bạn phải sử dụng các giá trị từ getSupportedPreviewSizes().
Đừng đặt giá trị tuỳ ý trong phương thức setPreviewSize().
Đặt bản xem trước trong một bố cục
Bạn phải đặt một lớp xem trước của máy ảnh (chẳng hạn như ví dụ trong phần trước) vào bố cục của một hoạt động cùng với các thành phần điều khiển giao diện người dùng khác để chụp ảnh hoặc quay video. Phần này hướng dẫn bạn cách tạo bố cục và hoạt động cơ bản cho bản xem trước.
Mã bố cục sau đây cung cấp một chế độ xem rất cơ bản có thể dùng để hiển thị bản xem trước của camera. Trong ví dụ này, phần tử FrameLayout được dùng làm vùng chứa cho lớp xem trước của máy ảnh. Loại bố cục này được dùng để có thể phủ thêm thông tin hoặc chế độ điều khiển hình ảnh lên hình ảnh xem trước trực tiếp của máy ảnh.
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:orientation="horizontal"
android:layout_width="fill_parent"
android:layout_height="fill_parent"
>
<FrameLayout
android:id="@+id/camera_preview"
android:layout_width="fill_parent"
android:layout_height="fill_parent"
android:layout_weight="1"
/>
<Button
android:id="@+id/button_capture"
android:text="Capture"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_gravity="center"
/>
</LinearLayout>
Trên hầu hết các thiết bị, hướng mặc định của bản xem trước camera là hướng ngang. Bố cục mẫu này chỉ định bố cục ngang (ngang) và mã bên dưới cố định hướng của ứng dụng thành ngang. Để đơn giản hoá việc kết xuất bản xem trước của máy ảnh, bạn nên thay đổi hướng hoạt động xem trước của ứng dụng thành hướng ngang bằng cách thêm đoạn mã sau vào tệp kê khai.
<activity android:name=".CameraActivity"
android:label="@string/app_name"
android:screenOrientation="landscape">
<!-- configure this activity to use landscape orientation -->
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
Trong hoạt động cho chế độ xem camera, hãy thêm lớp xem trước vào phần tử FrameLayout như trong ví dụ ở trên. Hoạt động của camera cũng phải đảm bảo rằng camera sẽ được giải phóng khi bị tạm dừng hoặc tắt. Ví dụ sau đây cho thấy cách sửa đổi hoạt động của máy ảnh để đính kèm lớp xem trước được trình bày trong phần Tạo lớp xem trước.
Kotlin
class CameraActivity : Activity() {
private var mCamera: Camera? = null
private var mPreview: CameraPreview? = null
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
// Create an instance of Camera
mCamera = getCameraInstance()
mPreview = mCamera?.let {
// Create our Preview view
CameraPreview(this, it)
}
// Set the Preview view as the content of our activity.
mPreview?.also {
val preview: FrameLayout = findViewById(R.id.camera_preview)
preview.addView(it)
}
}
}
Java
public class CameraActivity extends Activity {
private Camera mCamera;
private CameraPreview mPreview;
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
// Create an instance of Camera
mCamera = getCameraInstance();
// Create our Preview view and set it as the content of our activity.
mPreview = new CameraPreview(this, mCamera);
FrameLayout preview = (FrameLayout) findViewById(R.id.camera_preview);
preview.addView(mPreview);
}
}
Chụp ảnh
Sau khi tạo một lớp xem trước và bố cục khung hiển thị để hiển thị lớp đó, bạn đã sẵn sàng bắt đầu chụp ảnh bằng ứng dụng của mình. Trong mã xử lý ứng dụng, bạn phải thiết lập trình nghe cho các thành phần điều khiển giao diện người dùng để phản hồi hành động của người dùng bằng cách chụp ảnh.
Để truy xuất ảnh, hãy sử dụng phương thức Camera.takePicture(). Phương thức này lấy 3 tham số nhận dữ liệu từ camera.
Để nhận dữ liệu ở định dạng JPEG, bạn phải triển khai giao diện Camera.PictureCallback để nhận dữ liệu hình ảnh và ghi dữ liệu đó vào một tệp. Mã sau đây cho thấy cách triển khai cơ bản của giao diện Camera.PictureCallback để lưu hình ảnh nhận được từ máy ảnh.
Kotlin
private val mPicture = Camera.PictureCallback { data, _ ->
val pictureFile: File = getOutputMediaFile(MEDIA_TYPE_IMAGE) ?: run {
Log.d(TAG, ("Error creating media file, check storage permissions"))
return@PictureCallback
}
try {
val fos = FileOutputStream(pictureFile)
fos.write(data)
fos.close()
} catch (e: FileNotFoundException) {
Log.d(TAG, "File not found: ${e.message}")
} catch (e: IOException) {
Log.d(TAG, "Error accessing file: ${e.message}")
}
}
Java
private PictureCallback mPicture = new PictureCallback() {
@Override
public void onPictureTaken(byte[] data, Camera camera) {
File pictureFile = getOutputMediaFile(MEDIA_TYPE_IMAGE);
if (pictureFile == null){
Log.d(TAG, "Error creating media file, check storage permissions");
return;
}
try {
FileOutputStream fos = new FileOutputStream(pictureFile);
fos.write(data);
fos.close();
} catch (FileNotFoundException e) {
Log.d(TAG, "File not found: " + e.getMessage());
} catch (IOException e) {
Log.d(TAG, "Error accessing file: " + e.getMessage());
}
}
};
Kích hoạt tính năng chụp ảnh bằng cách gọi phương thức Camera.takePicture(). Đoạn mã ví dụ sau đây cho thấy cách gọi phương thức này từ một nút View.OnClickListener.
Kotlin
val captureButton: Button = findViewById(R.id.button_capture)
captureButton.setOnClickListener {
// get an image from the camera
mCamera?.takePicture(null, null, picture)
}
Java
// Add a listener to the Capture button
Button captureButton = (Button) findViewById(R.id.button_capture);
captureButton.setOnClickListener(
new View.OnClickListener() {
@Override
public void onClick(View v) {
// get an image from the camera
mCamera.takePicture(null, null, picture);
}
}
);
Quay video
Việc quay video bằng khung Android yêu cầu bạn phải quản lý cẩn thận đối tượng Camera và phối hợp với lớp MediaRecorder. Khi quay video bằng Camera, bạn phải quản lý các lệnh gọi Camera.lock() và Camera.unlock() để cho phép MediaRecorder truy cập vào phần cứng máy ảnh, ngoài các lệnh gọi Camera.open() và Camera.release().
Không giống như việc chụp ảnh bằng máy ảnh của thiết bị, việc quay video yêu cầu một thứ tự gọi rất cụ thể. Bạn phải tuân theo một thứ tự thực thi cụ thể để chuẩn bị và quay video thành công bằng ứng dụng của mình, như trình bày chi tiết bên dưới.
- Mở camera – Sử dụng
Camera.open()để lấy một thực thể của đối tượng camera. - Kết nối bản xem trước – Chuẩn bị bản xem trước hình ảnh trực tiếp của camera bằng cách kết nối
SurfaceViewvới camera bằngCamera.setPreviewDisplay(). - Bắt đầu xem trước – Gọi
Camera.startPreview()để bắt đầu hiển thị hình ảnh trực tiếp từ camera. Bắt đầu quay video – Bạn phải hoàn tất các bước sau theo thứ tự để quay video thành công:
- Mở khoá máy ảnh – Mở khoá máy ảnh để
MediaRecordersử dụng bằng cách gọiCamera.unlock(). Định cấu hình MediaRecorder – Gọi các phương thức
MediaRecordersau đây theo thứ tự này. Để biết thêm thông tin, hãy xem tài liệu tham khảo vềMediaRecorder.setCamera()– Đặt camera dùng để quay video; sử dụng thực thể hiện tại củaCameratrong ứng dụng.setAudioSource()– Đặt nguồn âm thanh; sử dụngMediaRecorder.AudioSource.CAMCORDER.setVideoSource()– Đặt nguồn video; sử dụngMediaRecorder.VideoSource.CAMERA.- Đặt định dạng và phương thức mã hoá đầu ra của video. Đối với Android 2.2 (cấp độ API 8) trở lên, hãy sử dụng phương thức
MediaRecorder.setProfilevà lấy một thực thể hồ sơ bằngCamcorderProfile.get(). Đối với các phiên bản Android trước 2.2, bạn phải đặt định dạng đầu ra video và các tham số mã hoá:setOutputFormat()– Đặt định dạng đầu ra; chỉ định chế độ cài đặt mặc định hoặcMediaRecorder.OutputFormat.MPEG_4.setAudioEncoder()– Đặt loại mã hoá âm thanh; chỉ định chế độ cài đặt mặc định hoặcMediaRecorder.AudioEncoder.AMR_NB.setVideoEncoder()– Đặt loại mã hoá video; chỉ định chế độ cài đặt mặc định hoặcMediaRecorder.VideoEncoder.MPEG_4_SP.
setOutputFile()– Đặt tệp đầu ra; sử dụnggetOutputMediaFile(MEDIA_TYPE_VIDEO).toString()từ phương thức ví dụ trong phần Lưu tệp nội dung nghe nhìn.setPreviewDisplay()– Chỉ định phần tử bố cục xem trướcSurfaceViewcho ứng dụng của bạn. Sử dụng cùng một đối tượng mà bạn đã chỉ định cho Connect Preview.
Chuẩn bị MediaRecorder – Chuẩn bị
MediaRecorderbằng các chế độ cài đặt cấu hình được cung cấp bằng cách gọiMediaRecorder.prepare().Bắt đầu MediaRecorder – Bắt đầu quay video bằng cách gọi
MediaRecorder.start().
- Mở khoá máy ảnh – Mở khoá máy ảnh để
Dừng quay video – Gọi các phương thức sau theo thứ tự để hoàn tất thành công quá trình quay video:
- Dừng MediaRecorder – Dừng quay video bằng cách gọi
MediaRecorder.stop(). - Đặt lại MediaRecorder – Nếu muốn, hãy xoá các chế độ cài đặt cấu hình khỏi trình ghi bằng cách gọi
MediaRecorder.reset(). - Giải phóng MediaRecorder – Giải phóng
MediaRecorderbằng cách gọiMediaRecorder.release(). - Khoá máy ảnh – Khoá máy ảnh để các phiên
MediaRecordertrong tương lai có thể sử dụng máy ảnh bằng cách gọiCamera.lock(). Kể từ Android 4.0 (cấp độ API 14), bạn không cần thực hiện lệnh gọi này trừ phi lệnh gọiMediaRecorder.prepare()không thành công.
- Dừng MediaRecorder – Dừng quay video bằng cách gọi
Dừng bản xem trước – Khi hoạt động của bạn đã sử dụng xong camera, hãy dừng bản xem trước bằng
Camera.stopPreview().Giải phóng camera – Giải phóng camera để các ứng dụng khác có thể sử dụng bằng cách gọi
Camera.release().
Đang định cấu hình MediaRecorder
Khi sử dụng lớp MediaRecorder để quay video, bạn phải thực hiện các bước định cấu hình theo thứ tự cụ thể, sau đó gọi phương thức MediaRecorder.prepare() để kiểm tra và triển khai cấu hình. Đoạn mã ví dụ sau đây minh hoạ cách định cấu hình và chuẩn bị đúng cách lớp MediaRecorder để quay video.
Kotlin
private fun prepareVideoRecorder(): Boolean {
mediaRecorder = MediaRecorder()
mCamera?.let { camera ->
// Step 1: Unlock and set camera to MediaRecorder
camera?.unlock()
mediaRecorder?.run {
setCamera(camera)
// Step 2: Set sources
setAudioSource(MediaRecorder.AudioSource.CAMCORDER)
setVideoSource(MediaRecorder.VideoSource.CAMERA)
// Step 3: Set a CamcorderProfile (requires API Level 8 or higher)
setProfile(CamcorderProfile.get(CamcorderProfile.QUALITY_HIGH))
// Step 4: Set output file
setOutputFile(getOutputMediaFile(MEDIA_TYPE_VIDEO).toString())
// Step 5: Set the preview output
setPreviewDisplay(mPreview?.holder?.surface)
setOutputFormat(MediaRecorder.OutputFormat.MPEG_4)
setAudioEncoder(MediaRecorder.AudioEncoder.DEFAULT)
setVideoEncoder(MediaRecorder.VideoEncoder.DEFAULT)
// Step 6: Prepare configured MediaRecorder
return try {
prepare()
true
} catch (e: IllegalStateException) {
Log.d(TAG, "IllegalStateException preparing MediaRecorder: ${e.message}")
releaseMediaRecorder()
false
} catch (e: IOException) {
Log.d(TAG, "IOException preparing MediaRecorder: ${e.message}")
releaseMediaRecorder()
false
}
}
}
return false
}
Java
private boolean prepareVideoRecorder(){
mCamera = getCameraInstance();
mediaRecorder = new MediaRecorder();
// Step 1: Unlock and set camera to MediaRecorder
mCamera.unlock();
mediaRecorder.setCamera(mCamera);
// Step 2: Set sources
mediaRecorder.setAudioSource(MediaRecorder.AudioSource.CAMCORDER);
mediaRecorder.setVideoSource(MediaRecorder.VideoSource.CAMERA);
// Step 3: Set a CamcorderProfile (requires API Level 8 or higher)
mediaRecorder.setProfile(CamcorderProfile.get(CamcorderProfile.QUALITY_HIGH));
// Step 4: Set output file
mediaRecorder.setOutputFile(getOutputMediaFile(MEDIA_TYPE_VIDEO).toString());
// Step 5: Set the preview output
mediaRecorder.setPreviewDisplay(mPreview.getHolder().getSurface());
// Step 6: Prepare configured MediaRecorder
try {
mediaRecorder.prepare();
} catch (IllegalStateException e) {
Log.d(TAG, "IllegalStateException preparing MediaRecorder: " + e.getMessage());
releaseMediaRecorder();
return false;
} catch (IOException e) {
Log.d(TAG, "IOException preparing MediaRecorder: " + e.getMessage());
releaseMediaRecorder();
return false;
}
return true;
}
Trước Android 2.2 (cấp độ API 8), bạn phải đặt trực tiếp các tham số định dạng đầu ra và định dạng mã hoá, thay vì sử dụng CamcorderProfile. Phương pháp này được minh hoạ trong đoạn mã sau:
Kotlin
// Step 3: Set output format and encoding (for versions prior to API Level 8)
mediaRecorder?.apply {
setOutputFormat(MediaRecorder.OutputFormat.MPEG_4)
setAudioEncoder(MediaRecorder.AudioEncoder.DEFAULT)
setVideoEncoder(MediaRecorder.VideoEncoder.DEFAULT)
}
Java
// Step 3: Set output format and encoding (for versions prior to API Level 8)
mediaRecorder.setOutputFormat(MediaRecorder.OutputFormat.MPEG_4);
mediaRecorder.setAudioEncoder(MediaRecorder.AudioEncoder.DEFAULT);
mediaRecorder.setVideoEncoder(MediaRecorder.VideoEncoder.DEFAULT);
Các tham số quay video sau đây cho MediaRecorder được cung cấp chế độ cài đặt mặc định, tuy nhiên, bạn có thể điều chỉnh các chế độ cài đặt này cho ứng dụng của mình:
setVideoEncodingBitRate()setVideoSize()setVideoFrameRate()setAudioEncodingBitRate()setAudioChannels()setAudioSamplingRate()
Bắt đầu và dừng MediaRecorder
Khi bắt đầu và dừng quay video bằng lớp MediaRecorder, bạn phải tuân theo một thứ tự cụ thể, như được liệt kê dưới đây.
- Mở khoá camera bằng
Camera.unlock() - Định cấu hình
MediaRecordernhư trong ví dụ về mã ở trên - Bắt đầu ghi bằng
MediaRecorder.start() - Quay video
- Dừng ghi bằng phím tắt
MediaRecorder.stop() - Giải phóng trình ghi nội dung nghe nhìn bằng
MediaRecorder.release() - Khoá máy ảnh bằng
Camera.lock()
Mã ví dụ sau đây minh hoạ cách kết nối một nút để bắt đầu và dừng quay video đúng cách bằng cách sử dụng máy ảnh và lớp MediaRecorder.
Kotlin
var isRecording = false
val captureButton: Button = findViewById(R.id.button_capture)
captureButton.setOnClickListener {
if (isRecording) {
// stop recording and release camera
mediaRecorder?.stop() // stop the recording
releaseMediaRecorder() // release the MediaRecorder object
mCamera?.lock() // take camera access back from MediaRecorder
// inform the user that recording has stopped
setCaptureButtonText("Capture")
isRecording = false
} else {
// initialize video camera
if (prepareVideoRecorder()) {
// Camera is available and unlocked, MediaRecorder is prepared,
// now you can start recording
mediaRecorder?.start()
// inform the user that recording has started
setCaptureButtonText("Stop")
isRecording = true
} else {
// prepare didn't work, release the camera
releaseMediaRecorder()
// inform user
}
}
}
Java
private boolean isRecording = false;
// Add a listener to the Capture button
Button captureButton = (Button) findViewById(id.button_capture);
captureButton.setOnClickListener(
new View.OnClickListener() {
@Override
public void onClick(View v) {
if (isRecording) {
// stop recording and release camera
mediaRecorder.stop(); // stop the recording
releaseMediaRecorder(); // release the MediaRecorder object
mCamera.lock(); // take camera access back from MediaRecorder
// inform the user that recording has stopped
setCaptureButtonText("Capture");
isRecording = false;
} else {
// initialize video camera
if (prepareVideoRecorder()) {
// Camera is available and unlocked, MediaRecorder is prepared,
// now you can start recording
mediaRecorder.start();
// inform the user that recording has started
setCaptureButtonText("Stop");
isRecording = true;
} else {
// prepare didn't work, release the camera
releaseMediaRecorder();
// inform user
}
}
}
}
);
Đang giải phóng camera
Camera là tài nguyên được các ứng dụng dùng chung trên một thiết bị. Ứng dụng của bạn có thể sử dụng camera sau khi nhận được một thực thể của Camera. Bạn phải đặc biệt lưu ý giải phóng đối tượng camera khi ứng dụng ngừng sử dụng và ngay khi ứng dụng bị tạm dừng (Activity.onPause()). Nếu ứng dụng không giải phóng camera đúng cách, thì mọi nỗ lực truy cập camera sau đó (bao gồm cả nỗ lực của chính ứng dụng) sẽ không thành công và có thể khiến ứng dụng của bạn hoặc các ứng dụng khác bị tắt.
Để giải phóng một thực thể của đối tượng Camera, hãy sử dụng phương thức Camera.release(), như trong mã ví dụ dưới đây.
Kotlin
class CameraActivity : Activity() {
private var mCamera: Camera?
private var preview: SurfaceView?
private var mediaRecorder: MediaRecorder?
override fun onPause() {
super.onPause()
releaseMediaRecorder() // if you are using MediaRecorder, release it first
releaseCamera() // release the camera immediately on pause event
}
private fun releaseMediaRecorder() {
mediaRecorder?.reset() // clear recorder configuration
mediaRecorder?.release() // release the recorder object
mediaRecorder = null
mCamera?.lock() // lock camera for later use
}
private fun releaseCamera() {
mCamera?.release() // release the camera for other applications
mCamera = null
}
}
Java
public class CameraActivity extends Activity {
private Camera mCamera;
private SurfaceView preview;
private MediaRecorder mediaRecorder;
...
@Override
protected void onPause() {
super.onPause();
releaseMediaRecorder(); // if you are using MediaRecorder, release it first
releaseCamera(); // release the camera immediately on pause event
}
private void releaseMediaRecorder(){
if (mediaRecorder != null) {
mediaRecorder.reset(); // clear recorder configuration
mediaRecorder.release(); // release the recorder object
mediaRecorder = null;
mCamera.lock(); // lock camera for later use
}
}
private void releaseCamera(){
if (mCamera != null){
mCamera.release(); // release the camera for other applications
mCamera = null;
}
}
}
Đang lưu tệp nội dung nghe nhìn
Các tệp nội dung nghe nhìn do người dùng tạo (chẳng hạn như ảnh và video) phải được lưu vào thư mục bộ nhớ ngoài của thiết bị (Thẻ SD) để tiết kiệm dung lượng hệ thống và cho phép người dùng truy cập vào các tệp này mà không cần thiết bị. Có nhiều vị trí thư mục có thể lưu tệp đa phương tiện trên thiết bị, tuy nhiên, chỉ có hai vị trí chuẩn mà bạn nên cân nhắc với tư cách là nhà phát triển:
Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_PICTURES)– Phương thức này trả về vị trí chuẩn, được chia sẻ và đề xuất để lưu ảnh và video. Thư mục này được chia sẻ (công khai), vì vậy, các ứng dụng khác có thể dễ dàng khám phá, đọc, thay đổi và xoá các tệp được lưu ở vị trí này. Nếu người dùng gỡ cài đặt ứng dụng của bạn, thì các tệp nội dung nghe nhìn được lưu vào vị trí này sẽ không bị xoá. Để tránh can thiệp vào ảnh và video hiện có của người dùng, bạn nên tạo một thư mục con cho các tệp nội dung nghe nhìn của ứng dụng trong thư mục này, như trong mã mẫu dưới đây. Phương thức này có trong Android 2.2 (API cấp 8). Để biết các lệnh gọi tương đương trong các phiên bản API cũ hơn, hãy xem phần Lưu tệp dùng chung.Context.getExternalFilesDir(Environment.DIRECTORY_PICTURES)– Phương thức này trả về một vị trí chuẩn để lưu ảnh và video liên kết với ứng dụng của bạn. Nếu ứng dụng của bạn bị gỡ cài đặt, thì mọi tệp được lưu ở vị trí này sẽ bị xoá. Tính năng bảo mật không được thực thi cho các tệp ở vị trí này và các ứng dụng khác có thể đọc, thay đổi và xoá các tệp đó.
Mã ví dụ sau đây minh hoạ cách tạo vị trí File hoặc Uri cho tệp nội dung nghe nhìn có thể dùng khi gọi camera của thiết bị bằng Intent hoặc trong quá trình Xây dựng ứng dụng camera.
Kotlin
val MEDIA_TYPE_IMAGE = 1
val MEDIA_TYPE_VIDEO = 2
/** Create a file Uri for saving an image or video */
private fun getOutputMediaFileUri(type: Int): Uri {
return Uri.fromFile(getOutputMediaFile(type))
}
/** Create a File for saving an image or video */
private fun getOutputMediaFile(type: Int): File? {
// To be safe, you should check that the SDCard is mounted
// using Environment.getExternalStorageState() before doing this.
val mediaStorageDir = File(
Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_PICTURES),
"MyCameraApp"
)
// This location works best if you want the created images to be shared
// between applications and persist after your app has been uninstalled.
// Create the storage directory if it does not exist
mediaStorageDir.apply {
if (!exists()) {
if (!mkdirs()) {
Log.d("MyCameraApp", "failed to create directory")
return null
}
}
}
// Create a media filename
val timeStamp = SimpleDateFormat("yyyyMMdd_HHmmss").format(Date())
return when (type) {
MEDIA_TYPE_IMAGE -> {
File("${mediaStorageDir.path}${File.separator}IMG_$timeStamp.jpg")
}
MEDIA_TYPE_VIDEO -> {
File("${mediaStorageDir.path}${File.separator}VID_$timeStamp.mp4")
}
else -> null
}
}
Java
public static final int MEDIA_TYPE_IMAGE = 1;
public static final int MEDIA_TYPE_VIDEO = 2;
/** Create a file Uri for saving an image or video */
private static Uri getOutputMediaFileUri(int type){
return Uri.fromFile(getOutputMediaFile(type));
}
/** Create a File for saving an image or video */
private static File getOutputMediaFile(int type){
// To be safe, you should check that the SDCard is mounted
// using Environment.getExternalStorageState() before doing this.
File mediaStorageDir = new File(Environment.getExternalStoragePublicDirectory(
Environment.DIRECTORY_PICTURES), "MyCameraApp");
// This location works best if you want the created images to be shared
// between applications and persist after your app has been uninstalled.
// Create the storage directory if it does not exist
if (! mediaStorageDir.exists()){
if (! mediaStorageDir.mkdirs()){
Log.d("MyCameraApp", "failed to create directory");
return null;
}
}
// Create a media filename
String timeStamp = new SimpleDateFormat("yyyyMMdd_HHmmss").format(new Date());
File mediaFile;
if (type == MEDIA_TYPE_IMAGE){
mediaFile = new File(mediaStorageDir.getPath() + File.separator +
"IMG_"+ timeStamp + ".jpg");
} else if(type == MEDIA_TYPE_VIDEO) {
mediaFile = new File(mediaStorageDir.getPath() + File.separator +
"VID_"+ timeStamp + ".mp4");
} else {
return null;
}
return mediaFile;
}
Để URI hỗ trợ hồ sơ công việc, trước tiên, hãy chuyển đổi URI tệp thành URI nội dung. Sau đó, hãy thêm URI nội dung vào
EXTRA_OUTPUT
của Intent.
Để biết thêm thông tin về cách lưu tệp trên thiết bị Android, hãy xem phần Bộ nhớ dữ liệu.
Tính năng của camera
Android hỗ trợ nhiều tính năng máy ảnh mà bạn có thể kiểm soát bằng ứng dụng máy ảnh, chẳng hạn như định dạng ảnh, chế độ đèn flash, chế độ cài đặt lấy nét và nhiều tính năng khác. Phần này liệt kê các tính năng phổ biến của máy ảnh và thảo luận ngắn gọn về cách sử dụng các tính năng đó. Bạn có thể truy cập và đặt hầu hết các tính năng của máy ảnh bằng cách sử dụng đối tượng Camera.Parameters. Tuy nhiên, có một số tính năng quan trọng cần nhiều chế độ cài đặt hơn trong Camera.Parameters. Các tính năng này được đề cập trong những phần sau:
Để biết thông tin chung về cách sử dụng các tính năng được kiểm soát thông qua Camera.Parameters, hãy xem phần Sử dụng các tính năng của máy ảnh. Để biết thêm thông tin chi tiết về cách sử dụng các tính năng được kiểm soát thông qua đối tượng tham số máy ảnh, hãy nhấp vào các đường liên kết trong danh sách tính năng bên dưới để xem tài liệu tham khảo API.
Bảng 1. Các tính năng phổ biến của máy ảnh được sắp xếp theo Cấp độ API Android mà các tính năng đó được giới thiệu.
| Tính năng | Cấp độ API: | Mô tả |
|---|---|---|
| Phát hiện khuôn mặt | 14 | Xác định khuôn mặt người trong ảnh và dùng khuôn mặt đó để lấy nét, đo sáng và cân bằng trắng |
| Vùng đo sáng | 14 | Chỉ định một hoặc nhiều vùng trong ảnh để tính toán cân bằng trắng |
| Điểm cần cải thiện | 14 | Đặt một hoặc nhiều vùng trong hình ảnh để lấy tiêu điểm |
White Balance Lock |
14 | Dừng hoặc bắt đầu tự động điều chỉnh cân bằng trắng |
Exposure Lock |
14 | Dừng hoặc bắt đầu điều chỉnh độ phơi sáng tự động |
Video Snapshot |
14 | Chụp ảnh trong khi quay video (chụp khung hình) |
| Video tua nhanh thời gian | 11 | Quay các khung hình có độ trễ nhất định để quay video tua nhanh thời gian |
Multiple Cameras |
9 | Hỗ trợ nhiều camera trên một thiết bị, bao gồm cả camera trước và camera sau |
Focus Distance |
9 | Báo cáo khoảng cách giữa camera và các đối tượng có vẻ như đang được lấy nét |
Zoom |
8 | Đặt độ phóng đại hình ảnh |
Exposure
Compensation |
8 | Tăng hoặc giảm mức độ phơi sáng |
GPS Data |
5 | Bao gồm hoặc bỏ qua dữ liệu vị trí địa lý cùng với hình ảnh |
White Balance |
5 | Đặt chế độ cân bằng trắng, chế độ này ảnh hưởng đến giá trị màu trong ảnh chụp |
Focus Mode |
5 | Đặt cách máy ảnh lấy nét vào một đối tượng, chẳng hạn như tự động, cố định, cận cảnh hoặc vô cực |
Scene Mode |
5 | Áp dụng chế độ đặt trước cho các loại tình huống chụp ảnh cụ thể như cảnh đêm, bãi biển, tuyết hoặc ánh nến |
JPEG Quality |
5 | Đặt mức nén cho hình ảnh JPEG, giúp tăng hoặc giảm chất lượng và kích thước tệp đầu ra của hình ảnh |
Flash Mode |
5 | Bật, tắt đèn flash hoặc sử dụng chế độ cài đặt tự động |
Color Effects |
5 | Áp dụng hiệu ứng màu cho hình ảnh đã chụp, chẳng hạn như đen trắng, tông màu nâu đỏ hoặc âm bản. |
Anti-Banding |
5 | Giảm hiệu ứng dải màu trong độ dốc màu do nén JPEG |
Picture Format |
1 | Chỉ định định dạng tệp cho ảnh |
Picture Size |
1 | Chỉ định kích thước pixel của ảnh đã lưu |
Đang kiểm tra phạm vi cung cấp của tính năng
Điều đầu tiên cần hiểu khi bắt đầu sử dụng các tính năng của máy ảnh trên thiết bị Android là không phải tất cả tính năng của máy ảnh đều được hỗ trợ trên mọi thiết bị. Ngoài ra, các thiết bị hỗ trợ một tính năng cụ thể có thể hỗ trợ tính năng đó ở các cấp độ khác nhau hoặc với các lựa chọn khác nhau. Do đó, một phần trong quy trình ra quyết định khi phát triển ứng dụng máy ảnh là quyết định tính năng máy ảnh nào bạn muốn hỗ trợ và ở mức độ nào. Sau khi đưa ra quyết định đó, bạn nên lên kế hoạch đưa mã vào ứng dụng camera để kiểm tra xem phần cứng thiết bị có hỗ trợ các tính năng đó hay không và xử lý lỗi một cách linh hoạt nếu không có tính năng nào đó.
Bạn có thể kiểm tra xem các tính năng của máy ảnh có hoạt động hay không bằng cách lấy một thực thể của đối tượng tham số của máy ảnh và kiểm tra các phương thức liên quan. Mã mẫu sau đây cho bạn biết cách lấy đối tượng Camera.Parameters và kiểm tra xem máy ảnh có hỗ trợ tính năng tự động lấy nét hay không:
Kotlin
val params: Camera.Parameters? = camera?.parameters
val focusModes: List<String>? = params?.supportedFocusModes
if (focusModes?.contains(Camera.Parameters.FOCUS_MODE_AUTO) == true) {
// Autofocus mode is supported
}
Java
// get Camera parameters
Camera.Parameters params = camera.getParameters();
List<String> focusModes = params.getSupportedFocusModes();
if (focusModes.contains(Camera.Parameters.FOCUS_MODE_AUTO)) {
// Autofocus mode is supported
}
Bạn có thể sử dụng kỹ thuật nêu trên cho hầu hết các tính năng của máy ảnh. Đối tượng Camera.Parameters cung cấp phương thức getSupported...(), is...Supported() hoặc getMax...() để xác định xem một tính năng có được hỗ trợ hay không (và ở mức độ nào).
Nếu ứng dụng của bạn cần có một số tính năng máy ảnh nhất định để hoạt động đúng cách, thì bạn có thể yêu cầu các tính năng đó bằng cách thêm vào tệp kê khai ứng dụng. Khi bạn khai báo việc sử dụng các tính năng cụ thể của máy ảnh, chẳng hạn như đèn flash và tính năng tự động lấy nét, Google Play sẽ hạn chế việc cài đặt ứng dụng của bạn trên các thiết bị không hỗ trợ những tính năng này. Để xem danh sách các tính năng của máy ảnh có thể khai báo trong tệp kê khai ứng dụng, hãy xem Tài liệu tham khảo về tính năng của tệp kê khai.
Sử dụng các tính năng của máy ảnh
Hầu hết các tính năng của máy ảnh đều được kích hoạt và kiểm soát bằng đối tượng Camera.Parameters. Bạn có thể lấy đối tượng này bằng cách trước tiên lấy một thực thể của đối tượng Camera, gọi phương thức getParameters(), thay đổi đối tượng tham số được trả về rồi đặt lại đối tượng đó vào đối tượng camera, như minh hoạ trong mã ví dụ sau:
Kotlin
val params: Camera.Parameters? = camera?.parameters
params?.focusMode = Camera.Parameters.FOCUS_MODE_AUTO
camera?.parameters = params
Java
// get Camera parameters
Camera.Parameters params = camera.getParameters();
// set the focus mode
params.setFocusMode(Camera.Parameters.FOCUS_MODE_AUTO);
// set Camera parameters
camera.setParameters(params);
Kỹ thuật này hoạt động cho gần như tất cả các tính năng của máy ảnh và hầu hết các tham số có thể thay đổi bất cứ lúc nào sau khi bạn có được một thực thể của đối tượng Camera. Người dùng thường có thể thấy ngay các thay đổi đối với tham số trong bản xem trước của máy ảnh trong ứng dụng.
Về mặt phần mềm, các thay đổi về tham số có thể mất vài khung hình để thực sự có hiệu lực khi phần cứng camera xử lý các hướng dẫn mới rồi gửi dữ liệu hình ảnh đã cập nhật.
Các tính năng khác của máy ảnh cần thêm mã để triển khai, bao gồm:
- Khu vực đo sáng và lấy nét
- Phát hiện khuôn mặt
- Video tua nhanh thời gian
Các phần sau đây trình bày sơ lược về cách triển khai các tính năng này.
Khu vực đo sáng và lấy nét
Trong một số trường hợp chụp ảnh, tính năng lấy nét tự động và đo sáng có thể không mang lại kết quả như bạn mong muốn. Kể từ Android 4.0 (cấp độ API 14), ứng dụng máy ảnh của bạn có thể cung cấp các chế độ điều khiển bổ sung để cho phép ứng dụng hoặc người dùng chỉ định các vùng trong hình ảnh để dùng cho việc xác định chế độ cài đặt tiêu điểm hoặc mức độ ánh sáng, đồng thời truyền các giá trị này đến phần cứng máy ảnh để dùng trong việc chụp ảnh hoặc quay video.
Các vùng đo sáng và lấy nét hoạt động rất giống với các tính năng khác của máy ảnh, trong đó bạn điều khiển các vùng này thông qua các phương thức trong đối tượng Camera.Parameters. Đoạn mã sau đây minh hoạ cách đặt hai vùng đo sáng cho một thực thể của Camera:
Kotlin
// Create an instance of Camera
camera = getCameraInstance()
// set Camera parameters
val params: Camera.Parameters? = camera?.parameters
params?.apply {
if (maxNumMeteringAreas > 0) { // check that metering areas are supported
meteringAreas = ArrayList<Camera.Area>().apply {
val areaRect1 = Rect(-100, -100, 100, 100) // specify an area in center of image
add(Camera.Area(areaRect1, 600)) // set weight to 60%
val areaRect2 = Rect(800, -1000, 1000, -800) // specify an area in upper right of image
add(Camera.Area(areaRect2, 400)) // set weight to 40%
}
}
camera?.parameters = this
}
Java
// Create an instance of Camera
camera = getCameraInstance();
// set Camera parameters
Camera.Parameters params = camera.getParameters();
if (params.getMaxNumMeteringAreas() > 0){ // check that metering areas are supported
List<Camera.Area> meteringAreas = new ArrayList<Camera.Area>();
Rect areaRect1 = new Rect(-100, -100, 100, 100); // specify an area in center of image
meteringAreas.add(new Camera.Area(areaRect1, 600)); // set weight to 60%
Rect areaRect2 = new Rect(800, -1000, 1000, -800); // specify an area in upper right of image
meteringAreas.add(new Camera.Area(areaRect2, 400)); // set weight to 40%
params.setMeteringAreas(meteringAreas);
}
camera.setParameters(params);
Đối tượng Camera.Area chứa hai tham số dữ liệu: Đối tượng Rect để chỉ định một khu vực trong trường nhìn của máy ảnh và giá trị trọng số, cho máy ảnh biết mức độ quan trọng của khu vực này trong việc đo sáng hoặc tính toán tiêu điểm.
Trường Rect trong đối tượng Camera.Area mô tả một hình chữ nhật được ánh xạ trên lưới đơn vị 2000 x 2000. Toạ độ -1000, -1000 đại diện cho góc trên cùng bên trái của hình ảnh camera và toạ độ 1000, 1000 đại diện cho góc dưới cùng bên phải của hình ảnh camera, như minh hoạ dưới đây.
Camera.Area trong bản xem trước của máy ảnh. Hộp màu xanh dương cho biết vị trí và hình dạng của một vùng camera có các giá trị Rect là 333,333,667,667.Các giới hạn của hệ toạ độ này luôn tương ứng với cạnh ngoài của hình ảnh hiển thị trong bản xem trước của camera và không thu nhỏ hoặc mở rộng theo mức thu phóng. Tương tự, việc xoay bản xem trước hình ảnh bằng Camera.setDisplayOrientation() không ánh xạ lại hệ toạ độ.
Phát hiện khuôn mặt
Đối với ảnh có người, khuôn mặt thường là phần quan trọng nhất của ảnh và nên được dùng để xác định cả tiêu điểm và cân bằng trắng khi chụp ảnh. Khung Android 4.0 (cấp độ API 14) cung cấp các API để nhận dạng khuôn mặt và tính toán chế độ cài đặt hình ảnh bằng công nghệ nhận dạng khuôn mặt.
Để sử dụng tính năng phát hiện khuôn mặt trong ứng dụng camera, bạn cần thực hiện một vài bước chung:
- Kiểm tra để đảm bảo thiết bị có hỗ trợ tính năng phát hiện khuôn mặt
- Tạo trình nghe phát hiện khuôn mặt
- Thêm trình nghe phát hiện khuôn mặt vào đối tượng camera
- Bắt đầu phát hiện khuôn mặt sau khi xem trước (và sau mỗi lần khởi động lại bản xem trước)
Tính năng phát hiện khuôn mặt không được hỗ trợ trên một số thiết bị. Bạn có thể kiểm tra xem tính năng này có được hỗ trợ hay không bằng cách gọi getMaxNumDetectedFaces(). Ví dụ về quy trình kiểm tra này được minh hoạ trong phương thức mẫu startFaceDetection() bên dưới.
Để nhận được thông báo và phản hồi khi phát hiện khuôn mặt, ứng dụng máy ảnh của bạn phải đặt trình nghe cho các sự kiện phát hiện khuôn mặt. Để làm việc này, bạn phải tạo một lớp trình nghe triển khai giao diện Camera.FaceDetectionListener như trong mã ví dụ dưới đây.
Kotlin
internal class MyFaceDetectionListener : Camera.FaceDetectionListener {
override fun onFaceDetection(faces: Array<Camera.Face>, camera: Camera) {
if (faces.isNotEmpty()) {
Log.d("FaceDetection", ("face detected: ${faces.size}" +
" Face 1 Location X: ${faces[0].rect.centerX()}" +
"Y: ${faces[0].rect.centerY()}"))
}
}
}
Java
class MyFaceDetectionListener implements Camera.FaceDetectionListener {
@Override
public void onFaceDetection(Face[] faces, Camera camera) {
if (faces.length > 0){
Log.d("FaceDetection", "face detected: "+ faces.length +
" Face 1 Location X: " + faces[0].rect.centerX() +
"Y: " + faces[0].rect.centerY() );
}
}
}
Sau khi tạo lớp này, bạn sẽ đặt lớp này vào đối tượng Camera của ứng dụng, như trong mã ví dụ dưới đây:
Kotlin
camera?.setFaceDetectionListener(MyFaceDetectionListener())
Java
camera.setFaceDetectionListener(new MyFaceDetectionListener());
Ứng dụng của bạn phải bắt đầu chức năng phát hiện khuôn mặt mỗi khi bạn bắt đầu (hoặc khởi động lại) bản xem trước của camera. Tạo một phương thức để bắt đầu phát hiện khuôn mặt để bạn có thể gọi phương thức đó khi cần, như trong mã ví dụ bên dưới.
Kotlin
fun startFaceDetection() {
// Try starting Face Detection
val params = mCamera?.parameters
// start face detection only *after* preview has started
params?.apply {
if (maxNumDetectedFaces > 0) {
// camera supports face detection, so can start it:
mCamera?.startFaceDetection()
}
}
}
Java
public void startFaceDetection(){
// Try starting Face Detection
Camera.Parameters params = mCamera.getParameters();
// start face detection only *after* preview has started
if (params.getMaxNumDetectedFaces() > 0){
// camera supports face detection, so can start it:
mCamera.startFaceDetection();
}
}
Bạn phải bắt đầu phát hiện khuôn mặt mỗi lần bạn bắt đầu (hoặc khởi động lại) bản xem trước của máy ảnh. Nếu bạn sử dụng lớp xem trước trong phần Tạo lớp xem trước, hãy thêm phương thức startFaceDetection() vào cả hai phương thức surfaceCreated() và surfaceChanged() trong lớp xem trước, như trong mã mẫu dưới đây.
Kotlin
override fun surfaceCreated(holder: SurfaceHolder) {
try {
mCamera.setPreviewDisplay(holder)
mCamera.startPreview()
startFaceDetection() // start face detection feature
} catch (e: IOException) {
Log.d(TAG, "Error setting camera preview: ${e.message}")
}
}
override fun surfaceChanged(holder: SurfaceHolder, format: Int, w: Int, h: Int) {
if (holder.surface == null) {
// preview surface does not exist
Log.d(TAG, "holder.getSurface() == null")
return
}
try {
mCamera.stopPreview()
} catch (e: Exception) {
// ignore: tried to stop a non-existent preview
Log.d(TAG, "Error stopping camera preview: ${e.message}")
}
try {
mCamera.setPreviewDisplay(holder)
mCamera.startPreview()
startFaceDetection() // re-start face detection feature
} catch (e: Exception) {
// ignore: tried to stop a non-existent preview
Log.d(TAG, "Error starting camera preview: ${e.message}")
}
}
Java
public void surfaceCreated(SurfaceHolder holder) {
try {
mCamera.setPreviewDisplay(holder);
mCamera.startPreview();
startFaceDetection(); // start face detection feature
} catch (IOException e) {
Log.d(TAG, "Error setting camera preview: " + e.getMessage());
}
}
public void surfaceChanged(SurfaceHolder holder, int format, int w, int h) {
if (holder.getSurface() == null){
// preview surface does not exist
Log.d(TAG, "holder.getSurface() == null");
return;
}
try {
mCamera.stopPreview();
} catch (Exception e){
// ignore: tried to stop a non-existent preview
Log.d(TAG, "Error stopping camera preview: " + e.getMessage());
}
try {
mCamera.setPreviewDisplay(holder);
mCamera.startPreview();
startFaceDetection(); // re-start face detection feature
} catch (Exception e){
// ignore: tried to stop a non-existent preview
Log.d(TAG, "Error starting camera preview: " + e.getMessage());
}
}
Video tua nhanh thời gian
Video tua nhanh thời gian cho phép người dùng tạo các đoạn video kết hợp những bức ảnh được chụp cách nhau vài giây hoặc vài phút. Tính năng này sử dụng MediaRecorder để ghi lại hình ảnh cho một chuỗi tua nhanh thời gian.
Để quay video tua nhanh thời gian bằng MediaRecorder, bạn phải định cấu hình đối tượng trình ghi như thể bạn đang quay video bình thường, đặt số khung hình đã chụp mỗi giây thành một số thấp và sử dụng một trong các chế độ cài đặt chất lượng tua nhanh thời gian, như trong ví dụ về mã dưới đây.
Kotlin
mediaRecorder.setProfile(CamcorderProfile.get(CamcorderProfile.QUALITY_TIME_LAPSE_HIGH))
mediaRecorder.setCaptureRate(0.1) // capture a frame every 10 seconds
Java
// Step 3: Set a CamcorderProfile (requires API Level 8 or higher)
mediaRecorder.setProfile(CamcorderProfile.get(CamcorderProfile.QUALITY_TIME_LAPSE_HIGH));
...
// Step 5.5: Set the video capture rate to a low number
mediaRecorder.setCaptureRate(0.1); // capture a frame every 10 seconds
Bạn phải thực hiện các chế độ cài đặt này trong một quy trình định cấu hình lớn hơn cho MediaRecorder. Để xem ví dụ về mã cấu hình đầy đủ, hãy xem phần Định cấu hình MediaRecorder. Sau khi hoàn tất cấu hình,
bạn bắt đầu quay video như thể bạn đang quay một đoạn video thông thường. Để biết thêm thông tin về cách định cấu hình và chạy MediaRecorder, hãy xem phần Quay video.
Các mẫu Camera2Video và HdrViewfinder minh hoạ thêm về việc sử dụng các API được trình bày trên trang này.
Các trường camera cần có quyền
Ứng dụng chạy Android 10 (API cấp 29) trở lên phải có quyền CAMERA để truy cập vào giá trị của các trường sau đây mà phương thức getCameraCharacteristics() trả về:
LENS_POSE_ROTATIONLENS_POSE_TRANSLATIONLENS_INTRINSIC_CALIBRATIONLENS_RADIAL_DISTORTIONLENS_POSE_REFERENCELENS_DISTORTIONLENS_INFO_HYPERFOCAL_DISTANCELENS_INFO_MINIMUM_FOCUS_DISTANCESENSOR_REFERENCE_ILLUMINANT1SENSOR_REFERENCE_ILLUMINANT2SENSOR_CALIBRATION_TRANSFORM1SENSOR_CALIBRATION_TRANSFORM2SENSOR_COLOR_TRANSFORM1SENSOR_COLOR_TRANSFORM2SENSOR_FORWARD_MATRIX1SENSOR_FORWARD_MATRIX2
Các đoạn mã mẫu khác
Để tải ứng dụng mẫu xuống, hãy xem Mẫu Camera2Basic và Ứng dụng mẫu CameraX chính thức.