หมายเหตุ: หน้านี้กล่าวถึงคลาส Camera ซึ่งเลิกใช้งานแล้ว เราขอแนะนำให้ใช้ CameraX หรือ Camera2 สำหรับบางกรณีการใช้งาน ทั้ง CameraX และ Camera2 รองรับ Android 5.0 (API ระดับ 21) ขึ้นไป
บทเรียนนี้จะสอนวิธีจับภาพโดยมอบหมายงานให้แอปกล้องอื่นในอุปกรณ์ (หากต้องการสร้างฟังก์ชันการทำงานของกล้องเอง โปรดดูหัวข้อการควบคุมกล้อง)
สมมติว่าคุณกำลังใช้บริการสภาพอากาศที่รวบรวมข้อมูลจากมวลชนซึ่งสร้างแผนที่สภาพอากาศทั่วโลกโดยการผสมผสานรูปภาพท้องฟ้าที่ถ่ายจากอุปกรณ์ที่ใช้แอปไคลเอ็นต์ของคุณ การผสานรวมรูปภาพเป็นเพียงส่วนเล็กๆ ของแอปพลิเคชัน คุณอยากถ่ายภาพโดยใช้เวลาน้อยที่สุด ไม่ใช่การคิดค้นกล้องขึ้นมาใหม่ แต่ไม่ต้องกังวล อุปกรณ์ Android ส่วนใหญ่มีแอปพลิเคชันกล้องอย่างน้อย 1 แอปติดตั้งไว้แล้ว ในบทเรียนนี้ คุณจะได้เรียนรู้วิธีทำให้อุปกรณ์ถ่ายภาพให้คุณ
ขอฟีเจอร์กล้อง
หากฟังก์ชันหลักของแอปพลิเคชันคือการถ่ายรูป ให้จำกัดการแสดงแอปพลิเคชันใน Google Play ไว้สำหรับอุปกรณ์ที่มีกล้องเท่านั้น หากต้องการโฆษณาว่าแอปพลิเคชันของคุณต้องใช้กล้อง ให้ใส่แท็ก <uses-feature>
ในไฟล์ Manifest ดังนี้
<manifest ... > <uses-feature android:name="android.hardware.camera" android:required="true" /> ... </manifest>
หากแอปพลิเคชันใช้กล้อง แต่ไม่จำเป็นต้องใช้กล้องในการทำงาน ให้ตั้งค่า android:required
เป็น false
แทน ซึ่ง Google Play จะอนุญาตให้อุปกรณ์ที่ไม่มีกล้องดาวน์โหลดแอปพลิเคชันของคุณได้ คุณต้องรับผิดชอบในการตรวจสอบความพร้อมใช้งานของกล้องขณะรันไทม์โดยเรียกใช้ hasSystemFeature(PackageManager.FEATURE_CAMERA_ANY)
หากไม่มีกล้อง คุณควรปิดใช้ฟีเจอร์กล้อง
รับภาพปก
หากการถ่ายภาพเพียงอย่างเดียวไม่ใช่เป้าหมายสูงสุดของแอป คุณอาจต้องการนำรูปภาพกลับมาจากแอปพลิเคชันกล้องและดำเนินการบางอย่างกับรูปภาพ
แอปพลิเคชันกล้อง Android จะเข้ารหัสรูปภาพในค่าที่ส่งคืน Intent
ที่ส่งไปยัง onActivityResult()
ในรูปแบบ Bitmap
ขนาดเล็กในส่วนเพิ่มเติม ภายใต้คีย์ "data"
โค้ดต่อไปนี้จะดึงข้อมูลรูปภาพนี้และแสดงใน ImageView
Kotlin
override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) { if (requestCode == REQUEST_IMAGE_CAPTURE && resultCode == RESULT_OK) { val imageBitmap = data.extras.get("data") as Bitmap imageView.setImageBitmap(imageBitmap) } }
Java
@Override protected void onActivityResult(int requestCode, int resultCode, Intent data) { if (requestCode == REQUEST_IMAGE_CAPTURE && resultCode == RESULT_OK) { Bundle extras = data.getExtras(); Bitmap imageBitmap = (Bitmap) extras.get("data"); imageView.setImageBitmap(imageBitmap); } }
หมายเหตุ: รูปภาพขนาดย่อนี้จาก "data"
อาจเหมาะสำหรับใช้เป็นไอคอน แต่อาจไม่เหมาะที่จะใช้เป็นภาพปก การจัดการกับรูปภาพขนาดเต็มจะใช้เวลานานกว่าเล็กน้อย
บันทึกรูปภาพขนาดเต็ม
แอปพลิเคชันกล้อง Android จะบันทึกรูปภาพขนาดเต็มหากคุณระบุไฟล์ที่จะบันทึก คุณต้องระบุชื่อไฟล์ที่สมบูรณ์ซึ่งแอปกล้องควรบันทึกรูปภาพ
โดยทั่วไปแล้ว รูปภาพที่ผู้ใช้ถ่ายด้วยกล้องของอุปกรณ์ควรบันทึกไว้ในอุปกรณ์ที่จัดเก็บข้อมูลภายนอกแบบสาธารณะเพื่อให้แอปทั้งหมดเข้าถึงได้ ไดเรกทอรีที่เหมาะสมสําหรับรูปภาพที่แชร์จะระบุโดย getExternalStoragePublicDirectory()
โดยมีอาร์กิวเมนต์ DIRECTORY_PICTURES
ไดเรกทอรีที่ระบุโดยวิธีการนี้จะแชร์กับแอปทั้งหมด ใน Android 9 (API ระดับ 28) และต่ำกว่า การอ่านและเขียนในไดเรกทอรีนี้ต้องใช้สิทธิ์ READ_EXTERNAL_STORAGE
และ WRITE_EXTERNAL_STORAGE
ตามลำดับ
<manifest ...> <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" /> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> ... </manifest>
ใน Android 10 (API ระดับ 29) ขึ้นไป ไดเรกทอรีที่เหมาะสมสำหรับการแชร์รูปภาพคือตาราง MediaStore.Images
คุณไม่จําเป็นต้องประกาศสิทธิ์เข้าถึงพื้นที่เก็บข้อมูลใดๆ ตราบใดที่แอปของคุณจําเป็นต้องเข้าถึงรูปภาพที่ผู้ใช้ถ่ายโดยใช้แอปของคุณเท่านั้น
อย่างไรก็ตาม หากต้องการให้รูปภาพเป็นแบบส่วนตัวสำหรับแอปของคุณเท่านั้น คุณสามารถใช้ไดเรกทอรีที่ Context.getExternalFilesDir()
มีให้แทน
ใน Android 4.3 และต่ำกว่า การเขียนลงในไดเรกทอรีนี้จะต้องมีสิทธิ์ WRITE_EXTERNAL_STORAGE
ด้วย ตั้งแต่ Android 4.4 เป็นต้นไป ไม่จำเป็นต้องขอสิทธิ์นี้อีกต่อไปเนื่องจากแอปอื่นๆ ไม่สามารถเข้าถึงไดเรกทอรีได้ คุณจึงประกาศได้ว่าควรขอสิทธิ์ใน Android เวอร์ชันที่ต่ำกว่าเท่านั้นโดยเพิ่มแอตทริบิวต์ maxSdkVersion
ดังนี้
<manifest ...> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="28" /> ... </manifest>
หมายเหตุ: ระบบจะลบไฟล์ที่คุณบันทึกไว้ในไดเรกทอรีที่ getExternalFilesDir()
หรือ getFilesDir()
ระบุเมื่อผู้ใช้ถอนการติดตั้งแอป
เมื่อเลือกไดเรกทอรีสำหรับไฟล์แล้ว คุณจะต้องสร้างชื่อไฟล์ที่ป้องกันการชนกัน
คุณอาจต้องบันทึกเส้นทางไว้ในตัวแปรสมาชิกเพื่อใช้ในภายหลังด้วย ต่อไปนี้คือตัวอย่างวิธีแก้ปัญหาในเมธอดที่แสดงชื่อไฟล์ที่ไม่ซ้ำกันสำหรับรูปภาพใหม่โดยใช้การประทับเวลา
(ตัวอย่างนี้ถือว่าคุณเรียกใช้เมธอดจากภายใน Context
)
Kotlin
lateinit var currentPhotoPath: String @Throws(IOException::class) private fun createImageFile(): File { // Create an image file name val timeStamp: String = SimpleDateFormat("yyyyMMdd_HHmmss").format(Date()) val storageDir: File = getExternalFilesDir(Environment.DIRECTORY_PICTURES) return File.createTempFile( "JPEG_${timeStamp}_", /* prefix */ ".jpg", /* suffix */ storageDir /* directory */ ).apply { // Save a file: path for use with ACTION_VIEW intents currentPhotoPath = absolutePath } }
Java
String currentPhotoPath; private File createImageFile() throws IOException { // Create an image file name String timeStamp = new SimpleDateFormat("yyyyMMdd_HHmmss").format(new Date()); String imageFileName = "JPEG_" + timeStamp + "_"; File storageDir = getExternalFilesDir(Environment.DIRECTORY_PICTURES); File image = File.createTempFile( imageFileName, /* prefix */ ".jpg", /* suffix */ storageDir /* directory */ ); // Save a file: path for use with ACTION_VIEW intents currentPhotoPath = image.getAbsolutePath(); return image; }
เมื่อใช้วิธีการนี้ในการสร้างไฟล์สำหรับรูปภาพแล้ว คุณสามารถสร้างและเรียกใช้ Intent
ดังนี้
Kotlin
private fun dispatchTakePictureIntent() { Intent(MediaStore.ACTION_IMAGE_CAPTURE).also { takePictureIntent -> // Ensure that there's a camera activity to handle the intent takePictureIntent.resolveActivity(packageManager)?.also { // Create the File where the photo should go val photoFile: File? = try { createImageFile() } catch (ex: IOException) { // Error occurred while creating the File ... null } // Continue only if the File was successfully created photoFile?.also { val photoURI: Uri = FileProvider.getUriForFile( this, "com.example.android.fileprovider", it ) takePictureIntent.putExtra(MediaStore.EXTRA_OUTPUT, photoURI) startActivityForResult(takePictureIntent, REQUEST_IMAGE_CAPTURE) } } } }
Java
private void dispatchTakePictureIntent() { Intent takePictureIntent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE); // Ensure that there's a camera activity to handle the intent if (takePictureIntent.resolveActivity(getPackageManager()) != null) { // Create the File where the photo should go File photoFile = null; try { photoFile = createImageFile(); } catch (IOException ex) { // Error occurred while creating the File ... } // Continue only if the File was successfully created if (photoFile != null) { Uri photoURI = FileProvider.getUriForFile(this, "com.example.android.fileprovider", photoFile); takePictureIntent.putExtra(MediaStore.EXTRA_OUTPUT, photoURI); startActivityForResult(takePictureIntent, REQUEST_IMAGE_CAPTURE); } } }
หมายเหตุ: เราใช้ getUriForFile(Context, String, File)
ซึ่งแสดงผล URI content://
สําหรับแอปเวอร์ชันใหม่กว่าที่กำหนดเป้าหมายเป็น Android 7.0 (API ระดับ 24) ขึ้นไป การส่ง file://
URI ข้ามขอบเขตแพ็กเกจจะทำให้เกิด FileUriExposedException
ดังนั้นตอนนี้เราจึงนำเสนอวิธีทั่วไปมากขึ้นในการจัดเก็บรูปภาพโดยใช้ FileProvider
ตอนนี้คุณต้องกำหนดค่า FileProvider
ในไฟล์ Manifest ของแอป ให้เพิ่มผู้ให้บริการลงในแอปพลิเคชัน ดังนี้
<application> ... <provider android:name="androidx.core.content.FileProvider" android:authorities="com.example.android.fileprovider" android:exported="false" android:grantUriPermissions="true"> <meta-data android:name="android.support.FILE_PROVIDER_PATHS" android:resource="@xml/file_paths"></meta-data> </provider> ... </application>
ตรวจสอบว่าสตริงหน่วยงานตรงกับอาร์กิวเมนต์ที่ 2 ของ getUriForFile(Context, String, File)
ในส่วนข้อมูลเมตาของคําจํากัดความของผู้ให้บริการ คุณจะเห็นว่าผู้ให้บริการคาดหวังให้กําหนดค่าเส้นทางที่มีสิทธิ์ในไฟล์ทรัพยากรเฉพาะ
<?xml version="1.0" encoding="utf-8"?> <paths xmlns:android="http://schemas.android.com/apk/res/android"> <external-files-path name="my_images" path="Pictures" /> </paths>
คอมโพเนนต์เส้นทางจะสอดคล้องกับเส้นทางที่ getExternalFilesDir()
แสดงผลเมื่อเรียกใช้ด้วย Environment.DIRECTORY_PICTURES
ตรวจสอบว่าคุณแทนที่ com.example.package.name
ด้วยชื่อแพ็กเกจจริงของแอป นอกจากนี้ โปรดอ่านเอกสารประกอบของ FileProvider
เพื่อดูคำอธิบายโดยละเอียดของตัวระบุเส้นทางที่คุณใช้ได้นอกเหนือจาก external-path
เพิ่มรูปภาพลงในแกลเลอรี
เมื่อสร้างรูปภาพผ่าน Intent คุณควรทราบว่ารูปภาพอยู่ที่ไหน เนื่องจากคุณเป็นผู้กำหนดตำแหน่งที่จะบันทึกตั้งแต่แรก สำหรับผู้ใช้รายอื่น วิธีที่ง่ายที่สุดในการทำให้รูปภาพเข้าถึงได้คือการทำให้เข้าถึงได้จากผู้ให้บริการสื่อของระบบ
หมายเหตุ: หากคุณบันทึกรูปภาพไว้ในไดเรกทอรีที่ getExternalFilesDir()
ระบุไว้ เครื่องมือสแกนสื่อจะเข้าถึงไฟล์ไม่ได้เนื่องจากไฟล์เหล่านั้นเป็นไฟล์ส่วนตัวสำหรับแอปของคุณ
ตัวอย่างวิธีการต่อไปนี้แสดงวิธีเรียกใช้เครื่องมือสแกนสื่อของระบบเพื่อเพิ่มรูปภาพลงในฐานข้อมูลของผู้ให้บริการสื่อ ซึ่งจะทำให้รูปภาพพร้อมใช้งานในแอปพลิเคชันแกลเลอรีของ Android และในแอปอื่นๆ
Kotlin
private fun galleryAddPic() { Intent(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE).also { mediaScanIntent -> val f = File(currentPhotoPath) mediaScanIntent.data = Uri.fromFile(f) sendBroadcast(mediaScanIntent) } }
Java
private void galleryAddPic() { Intent mediaScanIntent = new Intent(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE); File f = new File(currentPhotoPath); Uri contentUri = Uri.fromFile(f); mediaScanIntent.setData(contentUri); this.sendBroadcast(mediaScanIntent); }
ถอดรหัสรูปภาพที่ปรับขนาด
การจัดการรูปภาพขนาดเต็มหลายรูปอาจเป็นเรื่องยากเมื่อหน่วยความจำมีจำกัด หากพบว่าแอปพลิเคชันของคุณใช้หน่วยความจําไม่เพียงพอหลังจากแสดงรูปภาพเพียงไม่กี่รูป คุณสามารถลดจํานวนฮีปแบบไดนามิกที่ใช้ได้อย่างมากโดยการขยาย JPEG ให้เป็นอาร์เรย์หน่วยความจําที่ปรับขนาดให้ตรงกับขนาดของมุมมองปลายทางอยู่แล้ว ตัวอย่างเมธอดต่อไปนี้แสดงเทคนิคนี้
Kotlin
private fun setPic() { // Get the dimensions of the View val targetW: Int = imageView.width val targetH: Int = imageView.height val bmOptions = BitmapFactory.Options().apply { // Get the dimensions of the bitmap inJustDecodeBounds = true BitmapFactory.decodeFile(currentPhotoPath, bmOptions) val photoW: Int = outWidth val photoH: Int = outHeight // Determine how much to scale down the image val scaleFactor: Int = Math.max(1, Math.min(photoW / targetW, photoH / targetH)) // Decode the image file into a Bitmap sized to fill the View inJustDecodeBounds = false inSampleSize = scaleFactor inPurgeable = true } BitmapFactory.decodeFile(currentPhotoPath, bmOptions)?.also { bitmap -> imageView.setImageBitmap(bitmap) } }
Java
private void setPic() { // Get the dimensions of the View int targetW = imageView.getWidth(); int targetH = imageView.getHeight(); // Get the dimensions of the bitmap BitmapFactory.Options bmOptions = new BitmapFactory.Options(); bmOptions.inJustDecodeBounds = true; BitmapFactory.decodeFile(currentPhotoPath, bmOptions); int photoW = bmOptions.outWidth; int photoH = bmOptions.outHeight; // Determine how much to scale down the image int scaleFactor = Math.max(1, Math.min(photoW/targetW, photoH/targetH)); // Decode the image file into a Bitmap sized to fill the View bmOptions.inJustDecodeBounds = false; bmOptions.inSampleSize = scaleFactor; bmOptions.inPurgeable = true; Bitmap bitmap = BitmapFactory.decodeFile(currentPhotoPath, bmOptions); imageView.setImageBitmap(bitmap); }