আপনার পছন্দের ভাষায় কন্টেন্ট অনুবাদ করতে Google তার AI প্রযুক্তি ব্যবহার করে। AI-এর মাধ্যমে করা অনুবাদে ভুল থাকতে পারে।

কপি ও পেস্ট করুন

কপি ও পেস্ট করার জন্য Android ক্লিপবোর্ড-ভিত্তিক ফ্রেমওয়ার্ক নিম্নলিখিত সহ আদিম ও জটিল ডেটা টাইপ কাজ করে:

টেক্সট স্ট্রিং
জটিল ডেটা স্ট্রাকচার
টেক্সট ও বাইনারি স্ট্রিম ডেটা
অ্যাপ্লিকেশন অ্যাসেট

সহজ টেক্সট ডেটা সরাসরি ক্লিপবোর্ডে স্টোর করা হয়, যদিও জটিল ডেটা রেফারেন্স হিসেবে স্টোর করা হয় যা পেস্ট করা অ্যাপ্লিকেশন কন্টেন্ট প্রোভাইডারের সাথে সমাধান করে।

কপি ও পেস্ট করার সুবিধা কোনও অ্যাপ্লিকেশনের মধ্যে এবং ফ্রেমওয়ার্ক প্রয়োগ করে এমন অ্যাপ্লিকেশনগুলির মধ্যে কাজ করে।

ফ্রেমওয়ার্কের কিছু অংশ কন্টেন্ট প্রোভাইডার ব্যবহার করে বলে, এই ডকুমেন্ট ধরে নেয় যে Android কন্টেন্ট প্রোভাইডার API সম্পর্কে আপনার কিছুটা ধারণা আছে।

টেক্সট নিয়ে কাজ করা

কিছু কম্পোনেন্ট, নিম্নলিখিত সারণীতে দেখানো মতো, বক্সের বাইরে থেকে টেক্সট কপি ও পেস্ট করার সুবিধা দেয়।

কম্পোনেন্ট	টেক্সট কপি করা	টেক্সট পেস্ট করা হচ্ছে
BasicTextField	✅	✅
TextField	✅	✅
SelectionContainer	✅

যেমন, আপনি নিম্নলিখিত স্নিপেটে কার্ডের টেক্সট ক্লিপবোর্ডে কপি করতে পারেন এবং কপি করা টেক্সটটি TextField-এ পেস্ট করতে পারেন। টেক্সট পেস্ট করার জন্য মেনু দেখাতে, TextField আইকনে টাচ করে ধরে রাখুন অথবা কার্সর হ্যান্ডেলে ট্যাপ করুন।

val textFieldState = rememberTextFieldState()

Column {
    Card {
        SelectionContainer {
            Text("You can copy this text")
        }
    }
    BasicTextField(state = textFieldState)
}CopyAndPaste.kt

আপনি নিম্নলিখিত কীবোর্ড শর্টকাট ব্যবহার করে টেক্সট পেস্ট করতে পারবেন: Ctrl+V . এছাড়াও, কীবোর্ড শর্টকাট ডিফল্ট হিসেবে উপলভ্য। বিস্তারিত জানতে কীবোর্ড অ্যাকশন ম্যানেজ করা দেখুন।

`ClipboardManager`-এর সাথে কপি করুন

আপনি ClipboardManager ব্যবহার করে ক্লিপবোর্ডে টেক্সট কপি করতে পারবেন। এর setText() পদ্ধতি পাস করা AnnotatedString অবজেক্টকে ক্লিপবোর্ডে কপি করে। ব্যবহারকারী বোতামে ক্লিক করলে, নিম্নলিখিত স্নিপেট ক্লিপবোর্ডে "Hello, clipboard" কপি করে।

// Retrieve a ClipboardManager object
val clipboardManager = LocalClipboardManager.current

Button(
    onClick = {
        // Copy "Hello, clipboard" to the clipboard
        clipboardManager.setText(AnnotatedString("Hello, clipboard"))
    }
) {
    Text("Click to copy a text")
}CopyAndPaste.kt

নিচের স্নিপেটটি একই কাজ করে, তবে আপনাকে আরও সূক্ষ্ম কন্ট্রোল দেয়। একটি সাধারণ ব্যবহারের উদাহরণ হল পাসওয়ার্ডের মতো সংবেদনশীল কন্টেন্ট কপি করা। ClipEntry ক্লিপবোর্ডে থাকা আইটেমের বিবরণ দেয়। এতে একটি ClipData অবজেক্ট থাকে যা ক্লিপবোর্ডে থাকা ডেটা বর্ণনা করে। ClipData.newPlainText() পদ্ধতি হল একটি স্ট্রিং অবজেক্ট থেকে ClipData অবজেক্ট তৈরি করার একটি সুবিধাজনক পদ্ধতি। ClipboardManager অবজেক্টের উপর setClip() মেথড কল করে আপনি তৈরি করা ClipEntry অবজেক্ট ক্লিপবোর্ডে সেট করতে পারবেন।

// Retrieve a ClipboardManager object
val clipboardManager = LocalClipboardManager.current

Button(
    onClick = {
        val clipData = ClipData.newPlainText("plain text", "Hello, clipboard")
        val clipEntry = ClipEntry(clipData)
        clipboardManager.setClip(clipEntry)
    }
) {
    Text("Click to copy a text")
}CopyAndPaste.kt

ClipboardManager-এর মাধ্যমে পেস্ট করা

আপনি ClipboardManager-এর উপর getText() পদ্ধতি কল করে ক্লিপবোর্ডে কপি করা টেক্সট অ্যাক্সেস করতে পারবেন। এর getText() মেথড ক্লিপবোর্ডে কোনও টেক্সট কপি করা হলে AnnotatedString অবজেক্ট রিটার্ন করে। নিম্নলিখিত স্নিপেট ক্লিপবোর্ডে থাকা টেক্সটকে TextField-এ থাকা টেক্সটের সাথে যোগ করে।

val textFieldState = rememberTextFieldState()

Column {
    TextField(state = textFieldState)

    Button(
        onClick = {
            // The getText method returns an AnnotatedString object or null
            val annotatedString = clipboardManager.getText()
            if (annotatedString != null) {
                // The pasted text is placed on the tail of the TextField
                textFieldState.edit {
                    append(annotatedString.text)
                }
            }
        }
    ) {
        Text("Click to paste the text in the clipboard")
    }
}CopyAndPaste.kt

রিচ কন্টেন্ট নিয়ে কাজ করা

ব্যবহারকারীরা ছবি, ভিডিও এবং অন্যান্য অভিব্যক্তিপূর্ণ কন্টেন্ট পছন্দ করেন। আপনার অ্যাপ, ব্যবহারকারীকে ClipboardManager ও ClipEntry-এর মাধ্যমে রিচ কন্টেন্ট কপি করার সুবিধা দিতে পারে। contentReceiver মডিফায়ার আপনাকে রিচ কন্টেন্ট পেস্ট করার সুবিধা প্রয়োগ করতে সাহায্য করে।

রিচ কন্টেন্ট কপি করুন

আপনার অ্যাপ সরাসরি ক্লিপবোর্ডে রিচ কন্টেন্ট কপি করতে পারবে না। পরিবর্তে, আপনার অ্যাপ ক্লিপবোর্ডে একটি URI অবজেক্ট পাস করে এবং ContentProvider-এর মাধ্যমে কন্টেন্ট অ্যাক্সেস করার সুবিধা দেয়। নিচের কোড স্নিপেট থেকে কীভাবে ক্লিপবোর্ডে JPEG ছবি কপি করতে হয় তা জানতে পারবেন। আরও জানতে ডেটা স্ট্রিম কপি করুন বিকল্প দেখুন।

// Get a reference to the context
val context = LocalContext.current

Button(
    onClick = {
        // URI of the copied JPEG data
        val uri = Uri.parse("content://your.app.authority/0.jpg")
        // Create a ClipData object from the URI value
        // A ContentResolver finds a proper ContentProvider so that ClipData.newUri can set appropriate MIME type to the given URI
        val clipData = ClipData.newUri(context.contentResolver, "Copied", uri)
        // Create a ClipEntry object from the clipData value
        val clipEntry = ClipEntry(clipData)
        // Copy the JPEG data to the clipboard
        clipboardManager.setClip(clipEntry)
    }
) {
    Text("Copy a JPEG data")
}CopyAndPaste.kt

রিচ কন্টেন্ট পেস্ট করুন

contentReceiver মডিফায়ারের সাহায্যে, আপনি পরিবর্তিত কম্পোনেন্টে BasicTextField রিচ কন্টেন্ট পেস্ট করা ম্যানেজ করতে পারবেন। নিচের কোড স্নিপেটটি Uri অবজেক্টের তালিকায় পেস্ট করা ইমেজ ডেটার URI যোগ করে।

// A URI list of images
val imageList = remember { mutableStateListOf<Uri>() }

// Remember the ReceiveContentListener object as it is created inside a Composable scope
val receiveContentListener = remember {
    ReceiveContentListener { transferableContent ->
        // Handle the pasted data if it is image data
        when {
            // Check if the pasted data is an image or not
            transferableContent.hasMediaType(MediaType.Image) -> {
                // Handle for each ClipData.Item object
                // The consume() method returns a new TransferableContent object containging ignored ClipData.Item objects
                transferableContent.consume { item ->
                    val uri = item.uri
                    if (uri != null) {
                        imageList.add(uri)
                    }
                    // Mark the ClipData.Item object consumed when the retrieved URI is not null
                    uri != null
                }
            }
            // Return the given transferableContent when the pasted data is not an image
            else -> transferableContent
        }
    }
}

val textFieldState = rememberTextFieldState()

BasicTextField(
    state = textFieldState,
    modifier = Modifier
        .contentReceiver(receiveContentListener)
        .fillMaxWidth()
        .height(48.dp)
)CopyAndPaste.kt

contentReceiver মডিফায়ারটি আর্গুমেন্ট হিসেবে একটি ReceiveContentListener অবজেক্ট নেয় এবং ব্যবহারকারী পরিবর্তিত কম্পোনেন্টের মধ্যে BasicTextField ডেটা পেস্ট করলে, পাস করা অবজেক্টের onReceive মেথড কল করে।

onReceive পদ্ধতিতে একটি TransferableContent অবজেক্ট পাস করা হয়, যা এই ক্ষেত্রে পেস্ট করার মাধ্যমে অ্যাপের মধ্যে ট্রান্সফার করা যেতে পারে এমন ডেটা বর্ণনা করে। আপনি clipEntry অ্যাট্রিবিউট উল্লেখ করে ClipEntry অবজেক্ট অ্যাক্সেস করতে পারবেন।

একটি ClipEntry অবজেক্টে একাধিক ClipData.Item অবজেক্ট থাকতে পারে যেমন, ব্যবহারকারী একাধিক ছবি বেছে নিয়ে ক্লিপবোর্ডে কপি করলে। আপনাকে প্রতিটি ClipData.Item অবজেক্টের জন্য 'ব্যবহার করা হয়েছে' বা 'উপেক্ষা করা হয়েছে' হিসেবে চিহ্নিত করতে হবে এবং উপেক্ষা করা ClipData.Item অবজেক্ট সহ একটি TransferableContent ফেরত দিতে হবে যাতে সবচেয়ে কাছের পূর্বপুরুষ contentReceiver মডিফায়ার এটি পেতে পারে।

TransferableContent.hasMediaType() পদ্ধতি আপনাকে নির্ধারণ করতে সাহায্য করতে পারে যে TransferableContent অবজেক্টটি মিডিয়া টাইপ সহ কোনও আইটেম প্রদান করতে পারে কিনা। যেমন, TransferableContent অবজেক্ট কোনও ছবি প্রদান করতে পারলে, নিম্নলিখিত মেথড কল true রিটার্ন করে।

transferableContent.hasMediaType(MediaType.Image)CopyAndPaste.kt

জটিল ডেটা নিয়ে কাজ করা

আপনি যেভাবে রিচ কন্টেন্টের জন্য করেন, একই পদ্ধতিতে ক্লিপবোর্ডে জটিল ডেটা কপি করতে পারবেন। বিস্তারিত জানতে জটিল ডেটা কপি করতে কন্টেন্ট প্রোভাইডার ব্যবহার করুন নিবন্ধটি দেখুন।

এছাড়াও, আপনি রিচ কন্টেন্টের জন্য একই পদ্ধতিতে জটিল ডেটা পেস্ট করার বিষয়টি ম্যানেজ করতে পারবেন। আপনি পেস্ট করা ডেটার URI পেতে পারেন। আসল ডেটা ContentProvider থেকে ফিরিয়ে আনা যাবে। আরও তথ্যের জন্য প্রদানকারীর থেকে ডেটা ফিরিয়ে আনুন বিকল্প দেখুন।

কন্টেন্ট কপি করা সংক্রান্ত মতামত

ব্যবহারকারীরা ক্লিপবোর্ডে কন্টেন্ট কপি করার সময় ফিডব্যাক আশা করেন, তাই কপি ও পেস্ট করার ফ্রেমওয়ার্ক ছাড়াও, Android 13 (API লেভেল 33) ও তার পরবর্তী ভার্সনে কপি করার সময় Android ব্যবহারকারীদের ডিফল্ট UI দেখায়। এই ফিচারের কারণে, ডুপ্লিকেট বিজ্ঞপ্তি পাওয়ার ঝুঁকি থাকে। আপনি ডুপ্লিকেট বিজ্ঞপ্তি এড়িয়ে চলুন বিকল্প থেকে এই এজ কেস সম্পর্কে আরও জানতে পারবেন।

Android 13 ক্লিপবোর্ড বিজ্ঞপ্তি দেখানো অ্যানিমেশন — **ছবি ১.** Android 13 ও তার পরবর্তী যেকোনও ভার্সনে ক্লিপবোর্ডে কন্টেন্ট কপি করা হলে UI দেখানো হয়।

Android 12L (API লেভেল 32) ও তার আগের যেকোনও ভার্সনে কপি করার সময় ব্যবহারকারীদের ম্যানুয়ালি মতামত জানান। সাজেশন দেখুন।

সংবেদনশীল কন্টেন্ট

আপনি যদি ব্যবহারকারীকে পাসওয়ার্ডের মতো সংবেদনশীল কন্টেন্ট ক্লিপবোর্ডে কপি করার অনুমতি দেন, তাহলে আপনার অ্যাপকে অবশ্যই সিস্টেমকে জানাতে হবে যাতে সিস্টেম UI-তে কপি করা সংবেদনশীল কন্টেন্ট দেখানো এড়াতে পারে (ছবি ২)।

ClipboardManager অবজেক্টের উপর setClip() পদ্ধতি কল করার আগে আপনাকে অবশ্যই ClipData-এ ClipDescription-এ একটি ফ্ল্যাগ যোগ করতে হবে:

// If your app is compiled with the API level 33 SDK or higher.
clipData.apply {
    description.extras = PersistableBundle().apply {
        putBoolean(ClipDescription.EXTRA_IS_SENSITIVE, true)
    }
}

// If your app is compiled with a lower SDK.
clipData.apply {
    description.extras = PersistableBundle().apply {
        putBoolean("android.content.extra.IS_SENSITIVE", true)
    }
}CopyAndPaste.kt