ফটো পিকার

ফটো বাছাইকারী একটি ব্রাউজযোগ্য ইন্টারফেস প্রদান করে যা ব্যবহারকারীকে তাদের মিডিয়া লাইব্রেরির সাথে উপস্থাপন করে, নতুন থেকে পুরানো পর্যন্ত তারিখ অনুসারে সাজানো। গোপনীয়তার সর্বোত্তম অনুশীলন কোডল্যাবে দেখানো হয়েছে, ফটো পিকার ব্যবহারকারীদের সম্পূর্ণ মিডিয়া লাইব্রেরির পরিবর্তে শুধুমাত্র নির্বাচিত ছবি এবং ভিডিওগুলিতে আপনার অ্যাপ অ্যাক্সেস দেওয়ার জন্য একটি নিরাপদ, অন্তর্নির্মিত উপায় প্রদান করে৷

যাদের ডিভাইসে যোগ্য ক্লাউড মিডিয়া প্রদানকারী রয়েছে তারাও দূর থেকে সঞ্চিত ফটো এবং ভিডিও থেকে নির্বাচন করতে সক্ষম। ক্লাউড মিডিয়া প্রদানকারীদের সম্পর্কে আরও জানুন ।

টুলটি স্বয়ংক্রিয়ভাবে আপডেট হয়, কোনো কোড পরিবর্তনের প্রয়োজন ছাড়াই সময়ের সাথে সাথে আপনার অ্যাপের ব্যবহারকারীদের সম্প্রসারিত কার্যকারিতা প্রদান করে।

Jetpack কার্যকলাপ চুক্তি ব্যবহার করুন

ফটো পিকার ইন্টিগ্রেশনকে সহজ করার জন্য, androidx.activity লাইব্রেরির 1.7.0 বা উচ্চতর সংস্করণ অন্তর্ভুক্ত করুন।

ফটো পিকার চালু করতে নিম্নলিখিত কার্যকলাপ ফলাফল চুক্তি ব্যবহার করুন:

• একটি একক ছবি বা ভিডিও নির্বাচন করতে PickVisualMedia ।
• একাধিক ছবি বা ভিডিও নির্বাচন করতে PickMultipleVisualMedia ।

যদি কোনও ডিভাইসে ফটো বাছাইকারী উপলব্ধ না হয়, তবে লাইব্রেরি স্বয়ংক্রিয়ভাবে ACTION_OPEN_DOCUMENT অভিপ্রায় ক্রিয়াকে আহ্বান করে৷ এই অভিপ্রায়টি Android 4.4 (API স্তর 19) বা উচ্চতর চালিত ডিভাইসগুলিতে সমর্থিত। আপনি isPhotoPickerAvailable() কল করে একটি প্রদত্ত ডিভাইসে ফটো পিকার উপলব্ধ কিনা তা যাচাই করতে পারেন৷

একটি একক মিডিয়া আইটেম নির্বাচন করুন

একটি একক মিডিয়া আইটেম নির্বাচন করতে, নিম্নলিখিত কোড স্নিপেটে দেখানো হিসাবে PickVisualMedia কার্যকলাপ ফলাফল চুক্তি ব্যবহার করুন:

// Registers a photo picker activity launcher in single-select mode.
val pickMedia = registerForActivityResult(PickVisualMedia()) { uri ->
    // Callback is invoked after the user selects a media item or closes the
    // photo picker.
    if (uri != null) {
        Log.d("PhotoPicker", "Selected URI: $uri")
    } else {
        Log.d("PhotoPicker", "No media selected")
    }
}

// Include only one of the following calls to launch(), depending on the types
// of media that you want to let the user choose from.

// Launch the photo picker and let the user choose images and videos.
pickMedia.launch(PickVisualMediaRequest(PickVisualMedia.ImageAndVideo))

// Launch the photo picker and let the user choose only images.
pickMedia.launch(PickVisualMediaRequest(PickVisualMedia.ImageOnly))

// Launch the photo picker and let the user choose only videos.
pickMedia.launch(PickVisualMediaRequest(PickVisualMedia.VideoOnly))

// Launch the photo picker and let the user choose only images/videos of a
// specific MIME type, such as GIFs.
val mimeType = "image/gif"
pickMedia.launch(PickVisualMediaRequest(PickVisualMedia.SingleMimeType(mimeType)))

// Registers a photo picker activity launcher in single-select mode.
ActivityResultLauncher<PickVisualMediaRequest> pickMedia =
        registerForActivityResult(new PickVisualMedia(), uri -> {
    // Callback is invoked after the user selects a media item or closes the
    // photo picker.
    if (uri != null) {
        Log.d("PhotoPicker", "Selected URI: " + uri);
    } else {
        Log.d("PhotoPicker", "No media selected");
    }
});

// Include only one of the following calls to launch(), depending on the types
// of media that you want to let the user choose from.

// Launch the photo picker and let the user choose images and videos.
pickMedia.launch(new PickVisualMediaRequest.Builder()
        .setMediaType(PickVisualMedia.ImageAndVideo.INSTANCE)
        .build());

// Launch the photo picker and let the user choose only images.
pickMedia.launch(new PickVisualMediaRequest.Builder()
        .setMediaType(PickVisualMedia.ImageOnly.INSTANCE)
        .build());

// Launch the photo picker and let the user choose only videos.
pickMedia.launch(new PickVisualMediaRequest.Builder()
        .setMediaType(PickVisualMedia.VideoOnly.INSTANCE)
        .build());

// Launch the photo picker and let the user choose only images/videos of a
// specific MIME type, such as GIFs.
String mimeType = "image/gif";
pickMedia.launch(new PickVisualMediaRequest.Builder()
        .setMediaType(new PickVisualMedia.SingleMimeType(mimeType))
        .build());

একাধিক মিডিয়া আইটেম নির্বাচন করুন

একাধিক মিডিয়া আইটেম নির্বাচন করতে, সর্বাধিক সংখ্যক নির্বাচনযোগ্য মিডিয়া ফাইল সেট করুন, যেমনটি নিম্নলিখিত কোড স্নিপেটে দেখানো হয়েছে।

// Registers a photo picker activity launcher in multi-select mode.
// In this example, the app lets the user select up to 5 media files.
val pickMultipleMedia =
        registerForActivityResult(PickMultipleVisualMedia(5)) { uris ->
    // Callback is invoked after the user selects media items or closes the
    // photo picker.
    if (uris.isNotEmpty()) {
        Log.d("PhotoPicker", "Number of items selected: ${uris.size}")
    } else {
        Log.d("PhotoPicker", "No media selected")
    }
}

// For this example, launch the photo picker and let the user choose images
// and videos. If you want the user to select a specific type of media file,
// use the overloaded versions of launch(), as shown in the section about how
// to select a single media item.
pickMultipleMedia.launch(PickVisualMediaRequest(PickVisualMedia.ImageAndVideo))

// Registers a photo picker activity launcher in multi-select mode.
// In this example, the app lets the user select up to 5 media files.
ActivityResultLauncher<PickVisualMediaRequest> pickMultipleMedia =
        registerForActivityResult(new PickMultipleVisualMedia(5), uris -> {
    // Callback is invoked after the user selects media items or closes the
    // photo picker.
    if (!uris.isEmpty()) {
        Log.d("PhotoPicker", "Number of items selected: " + uris.size());
    } else {
        Log.d("PhotoPicker", "No media selected");
    }
});

// For this example, launch the photo picker and let the user choose images
// and videos. If you want the user to select a specific type of media file,
// use the overloaded versions of launch(), as shown in the section about how
// to select a single media item.
pickMultipleMedia.launch(new PickVisualMediaRequest.Builder()
        .setMediaType(PickVisualMedia.ImageAndVideo.INSTANCE)
        .build());

প্ল্যাটফর্মটি সর্বাধিক সংখ্যক ফাইল সীমাবদ্ধ করে যা আপনি ব্যবহারকারীকে ফটো পিকারে নির্বাচন করতে বলতে পারেন। এই সীমা অ্যাক্সেস করতে, getPickImagesMaxLimit() কল করুন। যেসব ডিভাইসে ফটো পিকার সমর্থিত নয়, সেখানে এই সীমা উপেক্ষা করা হয়।

ডিভাইসের প্রাপ্যতা

ফটো বাছাইকারী ডিভাইসে উপলব্ধ যা নিম্নলিখিত মানদণ্ড পূরণ করে:

• Android 11 (API লেভেল 30) বা উচ্চতর চালান
• Google সিস্টেম আপডেটের মাধ্যমে মডুলার সিস্টেম উপাদানগুলিতে পরিবর্তনগুলি পান৷

পুরানো ডিভাইসগুলি যেগুলি Android 4.4 (API স্তর 19) Android 10 (API স্তর 29) এর মাধ্যমে চালায় এবং Android 11 বা 12 চালিত Android Go ডিভাইসগুলি যেগুলি Google Play পরিষেবাগুলি সমর্থন করে সেগুলি ফটো পিকারের একটি ব্যাকপোর্টেড সংস্করণ ইনস্টল করতে পারে৷ Google Play পরিষেবার মাধ্যমে ব্যাকপোর্টেড ফটো পিকার মডিউলের স্বয়ংক্রিয় ইনস্টলেশন সক্ষম করতে, আপনার অ্যাপের ম্যানিফেস্ট ফাইলে <application> ট্যাগে নিম্নলিখিত এন্ট্রি যোগ করুন:

<!-- Trigger Google Play services to install the backported photo picker module. -->
<service android:name="com.google.android.gms.metadata.ModuleDependencies"
         android:enabled="false"
         android:exported="false"
         tools:ignore="MissingClass">
    <intent-filter>
        <action android:name="com.google.android.gms.metadata.MODULE_DEPENDENCIES" />
    </intent-filter>
    <meta-data android:name="photopicker_activity:0:required" android:value="" />
</service>

মিডিয়া ফাইল অ্যাক্সেস অব্যাহত রাখুন

ডিফল্টরূপে, ডিভাইস রিস্টার্ট না হওয়া পর্যন্ত বা আপনার অ্যাপ বন্ধ না হওয়া পর্যন্ত সিস্টেম আপনার অ্যাপটিকে মিডিয়া ফাইলগুলিতে অ্যাক্সেস দেয়। যদি আপনার অ্যাপটি দীর্ঘ সময় ধরে চলমান কাজ করে, যেমন ব্যাকগ্রাউন্ডে একটি বড় ফাইল আপলোড করা, তাহলে আপনার এই অ্যাক্সেসটি দীর্ঘ সময়ের জন্য অব্যাহত থাকার প্রয়োজন হতে পারে। এটি করতে, takePersistableUriPermission() পদ্ধতিতে কল করুন:

val flag = Intent.FLAG_GRANT_READ_URI_PERMISSION
context.contentResolver.takePersistableUriPermission(uri, flag)

int flag = Intent.FLAG_GRANT_READ_URI_PERMISSION;
context.contentResolver.takePersistableUriPermission(uri, flag);