ถ่ายภาพ

หมายเหตุ: หน้านี้กล่าวถึงคลาส 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) ในส่วนข้อมูลเมตาของคําจํากัดความของผู้ให้บริการ คุณจะเห็นว่าผู้ให้บริการคาดหวังให้กําหนดค่าเส้นทางที่มีสิทธิ์ในไฟล์ทรัพยากรเฉพาะ res/xml/file_paths.xml ต่อไปนี้คือเนื้อหาที่จําเป็นสําหรับตัวอย่างนี้

<?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);
}