এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

ইন্টিগ্রেট অ্যাসেট ডেলিভারি (কোটলিন এবং জাভা)

আপনার জাভা কোড থেকে আপনার অ্যাপের অ্যাসেট প্যাকগুলি অ্যাক্সেস করতে এই গাইডের ধাপগুলি ব্যবহার করুন৷

কোটলিন এবং জাভার জন্য তৈরি করুন

আপনার প্রোজেক্টের অ্যান্ড্রয়েড অ্যাপ বান্ডেলে প্লে অ্যাসেট ডেলিভারি তৈরি করতে নিম্নলিখিত ধাপগুলি ব্যবহার করুন। এই পদক্ষেপগুলি সম্পাদন করার জন্য আপনাকে Android স্টুডিও ব্যবহার করতে হবে না।

আপনার প্রজেক্টের build.gradle ফাইলে Android Gradle প্লাগইনের সংস্করণটি 4.0.0 বা তার পরবর্তী সংস্করণে আপডেট করুন।
আপনার প্রকল্পের শীর্ষ-স্তরের ডিরেক্টরিতে, সম্পদ প্যাকের জন্য একটি ডিরেক্টরি তৈরি করুন। এই ডিরেক্টরির নামটি সম্পদ প্যাক নাম হিসাবে ব্যবহৃত হয়। অ্যাসেট প্যাকের নাম অবশ্যই একটি অক্ষর দিয়ে শুরু করতে হবে এবং এতে শুধুমাত্র অক্ষর, সংখ্যা এবং আন্ডারস্কোর থাকতে পারে।

সম্পদ প্যাক ডিরেক্টরিতে, একটি build.gradle ফাইল তৈরি করুন এবং নিম্নলিখিত কোড যোগ করুন। নিশ্চিত করুন যে সম্পদ প্যাকের নাম এবং শুধুমাত্র একটি ডেলিভারি প্রকার উল্লেখ করুন:

গ্রোভি

// In the asset pack's build.gradle file:
plugins {
  id 'com.android.asset-pack'
}

assetPack {
    packName = "asset-pack-name" // Directory name for the asset pack
    dynamicDelivery {
        deliveryType = "[ install-time | fast-follow | on-demand ]"
    }
}

কোটলিন

// In the asset pack's build.gradle.kts file:
plugins {
  id("com.android.asset-pack")
}

assetPack {
  packName.set("asset-pack-name") // Directory name for the asset pack
  dynamicDelivery {
    deliveryType.set("[ install-time | fast-follow | on-demand ]")
  }
}

প্রজেক্টের অ্যাপ build.gradle ফাইলে, আপনার প্রোজেক্টের প্রতিটি অ্যাসেট প্যাকের নাম নিচে দেখানো মত যোগ করুন:
গ্রোভি
```
// In the app build.gradle file:
android {
    ...
    assetPacks = [":asset-pack-name", ":asset-pack2-name"]
}
```
কোটলিন
```
// In the app build.gradle.kts file:
android {
    ...
    assetPacks += listOf(":asset-pack-name", ":asset-pack2-name")
}
```
প্রজেক্টের settings.gradle ফাইলে, নিচের মত আপনার প্রোজেক্টের সমস্ত অ্যাসেট প্যাক অন্তর্ভুক্ত করুন:
গ্রোভি
```
// In the settings.gradle file:
include ':app'
include ':asset-pack-name'
include ':asset-pack2-name'
```
কোটলিন
```
// In the settings.gradle.kts file:
include(":app")
include(":asset-pack-name")
include(":asset-pack2-name")
```
সম্পদ প্যাক ডিরেক্টরিতে, নিম্নলিখিত সাবডিরেক্টরি তৈরি করুন: src/main/assets
src/main/assets ডিরেক্টরিতে সম্পদ রাখুন। আপনি এখানেও সাবডিরেক্টরি তৈরি করতে পারেন। আপনার অ্যাপ্লিকেশানের জন্য ডিরেক্টরি কাঠামোটি এখন নিম্নলিখিতগুলির মতো হওয়া উচিত:
- build.gradle
- settings.gradle
- app/
- asset-pack-name /build.gradle
- asset-pack-name /src/main/assets/ your-asset-directories
Gradle এর সাথে Android অ্যাপ বান্ডেল তৈরি করুন । জেনারেট করা অ্যাপ বান্ডেলে, রুট-লেভেল ডিরেক্টরিতে এখন নিম্নলিখিতগুলি অন্তর্ভুক্ত রয়েছে:
- asset-pack-name /manifest/AndroidManifest.xml : সম্পদ প্যাকের শনাক্তকারী এবং বিতরণ মোড কনফিগার করে
- asset-pack-name /assets/ your-asset-directories : যে ডিরেক্টরিতে সম্পদ প্যাকের অংশ হিসাবে বিতরণ করা সমস্ত সম্পদ রয়েছে
Gradle প্রতিটি সম্পদ প্যাকের জন্য ম্যানিফেস্ট তৈরি করে এবং আপনার জন্য assets/ ডিরেক্টরি আউটপুট করে।
(ঐচ্ছিক) যদি আপনি দ্রুত-অনুসরণ এবং অন-ডিমান্ড ডেলিভারি ব্যবহার করার পরিকল্পনা করেন তাহলে প্লে অ্যাসেট ডেলিভারি লাইব্রেরি অন্তর্ভুক্ত করুন
গ্রোভি
```
implementation "com.google.android.play:asset-delivery:2.2.2"
// For Kotlin use asset-delivery-ktx
implementation "com.google.android.play:asset-delivery-ktx:2.2.2"
```
কোটলিন
```
implementation("com.google.android.play:asset-delivery:2.2.2")
// For Kotlin use core-ktx
implementation("com.google.android.play:asset-delivery-ktx:2.2.2")
```
(ঐচ্ছিক) বিভিন্ন টেক্সচার কম্প্রেশন ফর্ম্যাট সমর্থন করতে আপনার অ্যাপ বান্ডেল কনফিগার করুন।

দ্রষ্টব্য: বান্ডেল করা সম্পদগুলি অ্যাক্সেস করার জন্য আপনাকে একটি স্বতন্ত্র APK হিসাবে না করে একটি অ্যাপ বান্ডেল হিসাবে আপনার অ্যাপ চালাতে হবে। অথবা, আপনি অ্যাপটিকে একটি বান্ডেলের পরিবর্তে একটি APK হিসাবে বিতরণ করতে ডিফল্ট রান/ডিবাগ কনফিগারেশন সম্পাদনা করতে পারেন। আপনার অ্যান্ড্রয়েড অ্যাপ বান্ডেল তৈরি এবং পরীক্ষা করুন দেখুন।

Play Asset Delivery API-এর সাথে একীভূত করুন

প্লে অ্যাসেট ডেলিভারি জাভা এপিআই অ্যাসেট প্যাকের অনুরোধ, ডাউনলোড ম্যানেজ করা এবং অ্যাসেট অ্যাক্সেস করার জন্য AssetPackManager ক্লাস প্রদান করে। প্রথমে আপনার প্রজেক্টে প্লে অ্যাসেট ডেলিভারি লাইব্রেরি যোগ করা নিশ্চিত করুন।

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

জাভা প্রোগ্রামিং ভাষার জন্য সম্পদ প্যাক প্রবাহ চিত্র

চিত্র 1. অ্যাসেট প্যাকগুলি অ্যাক্সেস করার জন্য ফ্লো ডায়াগ্রাম৷

ইন্সটল-টাইম ডেলিভারি

install-time হিসাবে কনফিগার করা সম্পদ প্যাকগুলি অ্যাপ লঞ্চের সময় অবিলম্বে উপলব্ধ। এই মোডে পরিবেশিত সম্পদগুলি অ্যাক্সেস করতে Java AssetManager API ব্যবহার করুন:

কোটলিন

import android.content.res.AssetManager
...
val context: Context = createPackageContext("com.example.app", 0)
val assetManager: AssetManager = context.assets
val stream: InputStream = assetManager.open("asset-name")

জাভা

import android.content.res.AssetManager;
...
Context context = createPackageContext("com.example.app", 0);
AssetManager assetManager = context.getAssets();
InputStream is = assetManager.open("asset-name");

দ্রুত-অনুসরণ এবং অন-ডিমান্ড ডেলিভারি

নিম্নলিখিত বিভাগগুলি ডাউনলোড করার আগে কীভাবে অ্যাসেট প্যাকগুলি সম্পর্কে তথ্য পেতে হয়, ডাউনলোড শুরু করতে API-কে কীভাবে কল করতে হয় এবং তারপরে ডাউনলোড করা প্যাকগুলি কীভাবে অ্যাক্সেস করতে হয় তা দেখায়৷ এই বিভাগগুলি fast-follow এবং on-demand সম্পদ প্যাকের ক্ষেত্রে প্রযোজ্য।

স্থিতি পরীক্ষা করুন

প্রতিটি অ্যাসেট প্যাক অ্যাপের অভ্যন্তরীণ স্টোরেজে একটি আলাদা ফোল্ডারে সংরক্ষণ করা হয়। একটি সম্পদ প্যাকের রুট ফোল্ডার নির্ধারণ করতে getPackLocation() পদ্ধতি ব্যবহার করুন। এই পদ্ধতি নিম্নলিখিত মান প্রদান করে:

রিটার্ন মান	স্ট্যাটাস
একটি বৈধ `AssetPackLocation` অবজেক্ট	সম্পদ প্যাক রুট ফোল্ডার `assetsPath()` এ অবিলম্বে অ্যাক্সেসের জন্য প্রস্তুত
`null`	অজানা সম্পদ প্যাক বা সম্পদ উপলব্ধ নেই

সম্পদ প্যাক সম্পর্কে ডাউনলোড তথ্য পান

অ্যাসেট প্যাক আনার আগে অ্যাপগুলিকে ডাউনলোডের আকার প্রকাশ করতে হবে। ডাউনলোডের আকার এবং প্যাকটি ইতিমধ্যে ডাউনলোড হচ্ছে কিনা তা নির্ধারণ করতে requestPackStates() বা getPackStates() পদ্ধতি ব্যবহার করুন।

কোটলিন

suspend fun requestPackStates(packNames: List<String>): AssetPackStates

জাভা

Task<AssetPackStates> getPackStates(List<String> packNames)

requestPackStates() হল একটি সাসপেন্ড ফাংশন যা একটি AssetPackStates অবজেক্ট ফেরত দেয় যখন getPackStates() হল একটি অ্যাসিঙ্ক্রোনাস পদ্ধতি যা একটি Task<AssetPackStates> প্রদান করে। একটি AssetPackStates অবজেক্টের packStates() পদ্ধতি একটি Map<String, AssetPackState> প্রদান করে। এই মানচিত্রে প্রতিটি অনুরোধ করা সম্পদ প্যাকের অবস্থা রয়েছে, এটির নামের দ্বারা কী করা হয়েছে:

কোটলিন

AssetPackStates#packStates(): Map<String, AssetPackState>

জাভা

Map<String, AssetPackState> AssetPackStates#packStates()

চূড়ান্ত অনুরোধ নিম্নলিখিত দ্বারা দেখানো হয়:

কোটলিন

const val assetPackName = "assetPackName"
coroutineScope.launch {
  try {
    val assetPackStates: AssetPackStates =
      manager.requestPackStates(listOf(assetPackName))
    val assetPackState: AssetPackState =
      assetPackStates.packStates()[assetPackName]
  } catch (e: RuntimeExecutionException) {
    Log.d("MainActivity", e.message)
  }
}

জাভা

final String assetPackName = "myasset";

assetPackManager
    .getPackStates(Collections.singletonList(assetPackName))
    .addOnCompleteListener(new OnCompleteListener<AssetPackStates>() {
        @Override
        public void onComplete(Task<AssetPackStates> task) {
            AssetPackStates assetPackStates;
            try {
                assetPackStates = task.getResult();
                AssetPackState assetPackState =
                    assetPackStates.packStates().get(assetPackName);
            } catch (RuntimeExecutionException e) {
                Log.d("MainActivity", e.getMessage());
                return;
            })

নিম্নলিখিত AssetPackState পদ্ধতিগুলি অ্যাসেট প্যাকের আকার, এখন পর্যন্ত ডাউনলোড করা পরিমাণ (যদি অনুরোধ করা হয়), এবং ইতিমধ্যে অ্যাপে স্থানান্তরিত পরিমাণ প্রদান করে:

একটি সম্পদ প্যাকের স্থিতি পেতে, status() পদ্ধতিটি ব্যবহার করুন, যা একটি পূর্ণসংখ্যা হিসাবে স্ট্যাটাস প্রদান করে যা AssetPackStatus ক্লাসের একটি ধ্রুবক ক্ষেত্রের সাথে সম্পর্কিত। একটি সম্পদ প্যাক যা এখনও ইনস্টল করা হয়নি তার স্থিতি AssetPackStatus.NOT_INSTALLED আছে।

যদি একটি অনুরোধ ব্যর্থ হয়, errorCode() পদ্ধতি ব্যবহার করুন, যার রিটার্ন মান AssetPackErrorCode ক্লাসের একটি ধ্রুবক ক্ষেত্রের সাথে মিলে যায়।

ইনস্টল করুন

requestFetch() বা fetch() পদ্ধতি ব্যবহার করুন প্রথমবারের মতো একটি অ্যাসেট প্যাক ডাউনলোড করতে বা অ্যাসেট প্যাকের আপডেট সম্পূর্ণ করার জন্য কল করুন:

কোটলিন

suspend fun AssetPackManager.requestFetch(packs: List<String>): AssetPackStates

জাভা

Task<AssetPackStates> fetch(List<String> packNames)

এই পদ্ধতিটি একটি AssetPackStates অবজেক্ট প্রদান করে যার মধ্যে প্যাকগুলির একটি তালিকা এবং তাদের প্রাথমিক ডাউনলোডের অবস্থা এবং আকার রয়েছে। যদি requestFetch() বা fetch() এর মাধ্যমে অনুরোধ করা কোনো অ্যাসেট প্যাক ইতিমধ্যেই ডাউনলোড করা হয়, তাহলে ডাউনলোডের স্ট্যাটাস ফেরত দেওয়া হয় এবং কোনও অতিরিক্ত ডাউনলোড শুরু হয় না।

ডাউনলোড স্টেট মনিটর

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

কোটলিন

fun registerListener(listener: AssetPackStateUpdatedListener)
fun unregisterListener(listener: AssetPackStateUpdatedListener)

জাভা

void registerListener(AssetPackStateUpdatedListener listener)
void unregisterListener(AssetPackStateUpdatedListener listener)

দ্রষ্টব্য: ব্যবহারকারী অ্যাপটি ইনস্টল বা আপডেট করার পরে প্লে স্টোর স্বয়ংক্রিয়ভাবে যেকোনো fast-follow প্যাক ডাউনলোড শুরু করে। যাইহোক, এই প্যাকগুলি অবিলম্বে ব্যবহারের জন্য প্রস্তুত নাও হতে পারে। প্রতিটি অ্যাপ লঞ্চের সময় আপনাকে অবশ্যই fast-follow প্যাকগুলির স্থিতি পরীক্ষা করতে হবে। ডাউনলোড চলমান থাকলে, একজন শ্রোতার সাথে এটি পর্যবেক্ষণ করুন। যদি ডাউনলোডটি বাতিল বা বিরাম দেওয়া হয়, আপনি এটিকে পুনরায় শুরু করতে পারেন fetch() পদ্ধতি ব্যবহার করে, যেমনটি ইনস্টল বিভাগে কভার করা আছে।

বড় ডাউনলোড

যদি ডাউনলোডটি 200 MB-এর চেয়ে বড় হয় এবং ব্যবহারকারী Wi-Fi-এ না থাকে, তাহলে ডাউনলোড শুরু হবে না যতক্ষণ না ব্যবহারকারী স্পষ্টভাবে একটি মোবাইল ডেটা সংযোগ ব্যবহার করে ডাউনলোডের সাথে এগিয়ে যাওয়ার জন্য তাদের সম্মতি দেন৷ একইভাবে, যদি ডাউনলোডটি বড় হয় এবং ব্যবহারকারী Wi-Fi হারান, ডাউনলোডটি বিরতি দেওয়া হয় এবং একটি মোবাইল ডেটা সংযোগ ব্যবহার করে এগিয়ে যাওয়ার জন্য স্পষ্ট সম্মতি প্রয়োজন৷ একটি পজ করা প্যাকে WAITING_FOR_WIFI স্টেট আছে। ব্যবহারকারীকে সম্মতির জন্য অনুরোধ জানানোর জন্য UI ফ্লো ট্রিগার করতে, showConfirmationDialog() পদ্ধতি ব্যবহার করুন।

মনে রাখবেন যে অ্যাপটি এই পদ্ধতিতে কল না করলে, ডাউনলোডটি বিরতি দেওয়া হয় এবং ব্যবহারকারী যখন Wi-Fi সংযোগে ফিরে আসে শুধুমাত্র তখনই স্বয়ংক্রিয়ভাবে পুনরায় শুরু হবে।

প্রয়োজনীয় ব্যবহারকারী নিশ্চিতকরণ

যদি একটি প্যাকের REQUIRES_USER_CONFIRMATION স্থিতি থাকে, তবে ব্যবহারকারী showConfirmationDialog() এর সাথে দেখানো ডায়ালগটি গ্রহণ না করা পর্যন্ত ডাউনলোডটি এগিয়ে যাবে না। এই স্থিতি ঘটতে পারে যখন অ্যাপটি প্লে দ্বারা স্বীকৃত না হয়—উদাহরণস্বরূপ, যদি অ্যাপটি সাইড-লোড হয়। মনে রাখবেন যে এই ক্ষেত্রে showConfirmationDialog() কল করলে অ্যাপটি আপডেট হবে। আপডেটের পরে, আপনাকে আবার সম্পদের জন্য অনুরোধ করতে হবে।

নিম্নলিখিত একটি শ্রোতা বাস্তবায়ন একটি উদাহরণ:

কোটলিন

private val activityResultLauncher = registerForActivityResult(
    ActivityResultContracts.StartIntentSenderForResult()
) { result ->
    if (result.resultCode == RESULT_OK) {
        Log.d(TAG, "Confirmation dialog has been accepted.")
    } else if (result.resultCode == RESULT_CANCELED) {
        Log.d(TAG, "Confirmation dialog has been denied by the user.")
    }
}

assetPackManager.registerListener { assetPackState ->
  when(assetPackState.status()) {
    AssetPackStatus.PENDING -> {
      Log.i(TAG, "Pending")
    }
    AssetPackStatus.DOWNLOADING -> {
      val downloaded = assetPackState.bytesDownloaded()
      val totalSize = assetPackState.totalBytesToDownload()
      val percent = 100.0 * downloaded / totalSize

      Log.i(TAG, "PercentDone=" + String.format("%.2f", percent))
    }
    AssetPackStatus.TRANSFERRING -> {
      // 100% downloaded and assets are being transferred.
      // Notify user to wait until transfer is complete.
    }
    AssetPackStatus.COMPLETED -> {
      // Asset pack is ready to use. Start the game.
    }
    AssetPackStatus.FAILED -> {
      // Request failed. Notify user.
      Log.e(TAG, assetPackState.errorCode())
    }
    AssetPackStatus.CANCELED -> {
      // Request canceled. Notify user.
    }
    AssetPackStatus.WAITING_FOR_WIFI,
    AssetPackStatus.REQUIRES_USER_CONFIRMATION -> {
      if (!confirmationDialogShown) {
        assetPackManager.showConfirmationDialog(activityResultLauncher);
        confirmationDialogShown = true
      }
    }
    AssetPackStatus.NOT_INSTALLED -> {
      // Asset pack is not downloaded yet.
    }
    AssetPackStatus.UNKNOWN -> {
      Log.wtf(TAG, "Asset pack status unknown")
    }
  }
}

জাভা

assetPackStateUpdateListener = new AssetPackStateUpdateListener() {
    private final ActivityResultLauncher<IntentSenderRequest> activityResultLauncher =
      registerForActivityResult(
          new ActivityResultContracts.StartIntentSenderForResult(),
          new ActivityResultCallback<ActivityResult>() {
            @Override
            public void onActivityResult(ActivityResult result) {
              if (result.getResultCode() == RESULT_OK) {
                Log.d(TAG, "Confirmation dialog has been accepted.");
              } else if (result.getResultCode() == RESULT_CANCELED) {
                Log.d(TAG, "Confirmation dialog has been denied by the user.");
              }
            }
          });

    @Override
    public void onStateUpdate(AssetPackState assetPackState) {
      switch (assetPackState.status()) {
        case AssetPackStatus.PENDING:
          Log.i(TAG, "Pending");
          break;

        case AssetPackStatus.DOWNLOADING:
          long downloaded = assetPackState.bytesDownloaded();
          long totalSize = assetPackState.totalBytesToDownload();
          double percent = 100.0 * downloaded / totalSize;

          Log.i(TAG, "PercentDone=" + String.format("%.2f", percent));
          break;

        case AssetPackStatus.TRANSFERRING:
          // 100% downloaded and assets are being transferred.
          // Notify user to wait until transfer is complete.
          break;

        case AssetPackStatus.COMPLETED:
          // Asset pack is ready to use. Start the game.
          break;

        case AssetPackStatus.FAILED:
          // Request failed. Notify user.
          Log.e(TAG, assetPackState.errorCode());
          break;

        case AssetPackStatus.CANCELED:
          // Request canceled. Notify user.
          break;

        case AssetPackStatus.WAITING_FOR_WIFI:
        case AssetPackStatus.REQUIRES_USER_CONFIRMATION:
          if (!confirmationDialogShown) {
            assetPackManager.showConfirmationDialog(activityResultLauncher);
            confirmationDialogShown = true;
          }
          break;

        case AssetPackStatus.NOT_INSTALLED:
          // Asset pack is not downloaded yet.
          break;
        case AssetPackStatus.UNKNOWN:
          Log.wtf(TAG, "Asset pack status unknown")
          break;
      }
    }
}

বিকল্পভাবে, আপনি বর্তমান ডাউনলোডের স্থিতি পেতে getPackStates() পদ্ধতি ব্যবহার করতে পারেন। AssetPackStates ডাউনলোডের অগ্রগতি, ডাউনলোডের স্থিতি এবং যেকোন ব্যর্থতার ত্রুটি কোড ধারণ করে।

অ্যাসেট প্যাকগুলি অ্যাক্সেস করুন

ডাউনলোডের অনুরোধ COMPLETED অবস্থায় পৌঁছানোর পরে আপনি ফাইল সিস্টেম কল ব্যবহার করে একটি সম্পদ প্যাক অ্যাক্সেস করতে পারেন। সম্পদ প্যাকের রুট ফোল্ডার পেতে getPackLocation() পদ্ধতি ব্যবহার করুন।

সম্পদগুলি সম্পদ প্যাক রুট ডিরেক্টরির মধ্যে assets ডিরেক্টরিতে সংরক্ষণ করা হয়। আপনি সুবিধার পদ্ধতি assetsPath() ব্যবহার করে assets ডিরেক্টরির পথ পেতে পারেন। একটি নির্দিষ্ট সম্পদের পথ পেতে নিম্নলিখিত পদ্ধতি ব্যবহার করুন:

কোটলিন

private fun getAbsoluteAssetPath(assetPack: String, relativeAssetPath: String): String? {
    val assetPackPath: AssetPackLocation =
      assetPackManager.getPackLocation(assetPack)
      // asset pack is not ready
      ?: return null

    val assetsFolderPath = assetPackPath.assetsPath()
    // equivalent to: FilenameUtils.concat(assetPackPath.path(), "assets")
    return FilenameUtils.concat(assetsFolderPath, relativeAssetPath)
}

জাভা

private String getAbsoluteAssetPath(String assetPack, String relativeAssetPath) {
    AssetPackLocation assetPackPath = assetPackManager.getPackLocation(assetPack);

    if (assetPackPath == null) {
        // asset pack is not ready
        return null;
    }

    String assetsFolderPath = assetPackPath.assetsPath();
    // equivalent to: FilenameUtils.concat(assetPackPath.path(), "assets");
    String assetPath = FilenameUtils.concat(assetsFolderPath, relativeAssetPath);
    return assetPath;
}

অন্যান্য Play সম্পদ বিতরণ API পদ্ধতি

নিম্নলিখিত কিছু অতিরিক্ত API পদ্ধতি রয়েছে যা আপনি আপনার অ্যাপে ব্যবহার করতে চাইতে পারেন।

অনুরোধ বাতিল করুন

একটি সক্রিয় সম্পদ প্যাক অনুরোধ বাতিল করতে cancel() ব্যবহার করুন। মনে রাখবেন যে এই অনুরোধটি একটি সর্বোত্তম-প্রচেষ্টা অপারেশন।

একটি সম্পদ প্যাক সরান

একটি সম্পদ প্যাক অপসারণের সময়সূচী করতে requestRemovePack() বা removePack() ব্যবহার করুন।

একাধিক সম্পদ প্যাকের অবস্থান পান

বাল্কে একাধিক অ্যাসেট প্যাকের স্ট্যাটাস জিজ্ঞাসা করতে getPackLocations() ব্যবহার করুন, যা অ্যাসেট প্যাক এবং তাদের অবস্থানগুলির একটি মানচিত্র প্রদান করে৷ getPackLocations() দ্বারা প্রত্যাবর্তিত মানচিত্রে বর্তমানে ডাউনলোড করা এবং আপ-টু-ডেট প্রতিটি প্যাকের জন্য একটি এন্ট্রি রয়েছে।

পরবর্তী ধাপ

স্থানীয়ভাবে এবং Google Play থেকে প্লে অ্যাসেট ডেলিভারি পরীক্ষা করুন ।

কোটলিন এবং জাভার জন্য তৈরি করুন

আপনার প্রজেক্টের build.gradle ফাইলে Android Gradle প্লাগইনের সংস্করণটি 4.0.0 বা তার পরবর্তী সংস্করণে আপডেট করুন।
আপনার প্রকল্পের শীর্ষ-স্তরের ডিরেক্টরিতে, সম্পদ প্যাকের জন্য একটি ডিরেক্টরি তৈরি করুন। এই ডিরেক্টরির নামটি সম্পদ প্যাক নাম হিসাবে ব্যবহৃত হয়। অ্যাসেট প্যাকের নাম অবশ্যই একটি অক্ষর দিয়ে শুরু করতে হবে এবং এতে শুধুমাত্র অক্ষর, সংখ্যা এবং আন্ডারস্কোর থাকতে পারে।

গ্রোভি

// In the asset pack's build.gradle file:
plugins {
  id 'com.android.asset-pack'
}

assetPack {
    packName = "asset-pack-name" // Directory name for the asset pack
    dynamicDelivery {
        deliveryType = "[ install-time | fast-follow | on-demand ]"
    }
}

কোটলিন

// In the asset pack's build.gradle.kts file:
plugins {
  id("com.android.asset-pack")
}

assetPack {
  packName.set("asset-pack-name") // Directory name for the asset pack
  dynamicDelivery {
    deliveryType.set("[ install-time | fast-follow | on-demand ]")
  }
}

প্রজেক্টের অ্যাপ build.gradle ফাইলে, আপনার প্রোজেক্টের প্রতিটি অ্যাসেট প্যাকের নাম নিচে দেখানো মত যোগ করুন:
গ্রোভি
```
// In the app build.gradle file:
android {
    ...
    assetPacks = [":asset-pack-name", ":asset-pack2-name"]
}
```
কোটলিন
```
// In the app build.gradle.kts file:
android {
    ...
    assetPacks += listOf(":asset-pack-name", ":asset-pack2-name")
}
```
প্রজেক্টের settings.gradle ফাইলে, নিচের মত আপনার প্রোজেক্টের সমস্ত অ্যাসেট প্যাক অন্তর্ভুক্ত করুন:
গ্রোভি
```
// In the settings.gradle file:
include ':app'
include ':asset-pack-name'
include ':asset-pack2-name'
```
কোটলিন
```
// In the settings.gradle.kts file:
include(":app")
include(":asset-pack-name")
include(":asset-pack2-name")
```
সম্পদ প্যাক ডিরেক্টরিতে, নিম্নলিখিত সাবডিরেক্টরি তৈরি করুন: src/main/assets
src/main/assets ডিরেক্টরিতে সম্পদ রাখুন। আপনি এখানেও সাবডিরেক্টরি তৈরি করতে পারেন। আপনার অ্যাপ্লিকেশানের জন্য ডিরেক্টরি কাঠামোটি এখন নিম্নলিখিতগুলির মতো হওয়া উচিত:
- build.gradle
- settings.gradle
- app/
- asset-pack-name /build.gradle
- asset-pack-name /src/main/assets/ your-asset-directories
Gradle এর সাথে Android অ্যাপ বান্ডেল তৈরি করুন । জেনারেট করা অ্যাপ বান্ডেলে, রুট-লেভেল ডিরেক্টরিতে এখন নিম্নলিখিতগুলি অন্তর্ভুক্ত রয়েছে:
- asset-pack-name /manifest/AndroidManifest.xml : সম্পদ প্যাকের শনাক্তকারী এবং বিতরণ মোড কনফিগার করে
- asset-pack-name /assets/ your-asset-directories : যে ডিরেক্টরিতে সম্পদ প্যাকের অংশ হিসাবে বিতরণ করা সমস্ত সম্পদ রয়েছে
Gradle প্রতিটি সম্পদ প্যাকের জন্য ম্যানিফেস্ট তৈরি করে এবং আপনার জন্য assets/ ডিরেক্টরি আউটপুট করে।
(ঐচ্ছিক) যদি আপনি দ্রুত-অনুসরণ এবং অন-ডিমান্ড ডেলিভারি ব্যবহার করার পরিকল্পনা করেন তাহলে প্লে অ্যাসেট ডেলিভারি লাইব্রেরি অন্তর্ভুক্ত করুন
গ্রোভি
```
implementation "com.google.android.play:asset-delivery:2.2.2"
// For Kotlin use asset-delivery-ktx
implementation "com.google.android.play:asset-delivery-ktx:2.2.2"
```
কোটলিন
```
implementation("com.google.android.play:asset-delivery:2.2.2")
// For Kotlin use core-ktx
implementation("com.google.android.play:asset-delivery-ktx:2.2.2")
```
(ঐচ্ছিক) বিভিন্ন টেক্সচার কম্প্রেশন ফর্ম্যাট সমর্থন করতে আপনার অ্যাপ বান্ডেল কনফিগার করুন।

Play Asset Delivery API-এর সাথে একীভূত করুন

জাভা প্রোগ্রামিং ভাষার জন্য সম্পদ প্যাক প্রবাহ চিত্র

চিত্র 1. অ্যাসেট প্যাকগুলি অ্যাক্সেস করার জন্য ফ্লো ডায়াগ্রাম৷

ইন্সটল-টাইম ডেলিভারি

কোটলিন

import android.content.res.AssetManager
...
val context: Context = createPackageContext("com.example.app", 0)
val assetManager: AssetManager = context.assets
val stream: InputStream = assetManager.open("asset-name")

জাভা

import android.content.res.AssetManager;
...
Context context = createPackageContext("com.example.app", 0);
AssetManager assetManager = context.getAssets();
InputStream is = assetManager.open("asset-name");

দ্রুত-অনুসরণ এবং অন-ডিমান্ড ডেলিভারি

স্থিতি পরীক্ষা করুন

রিটার্ন মান	স্ট্যাটাস
একটি বৈধ `AssetPackLocation` অবজেক্ট	সম্পদ প্যাক রুট ফোল্ডার `assetsPath()` এ অবিলম্বে অ্যাক্সেসের জন্য প্রস্তুত
`null`	অজানা সম্পদ প্যাক বা সম্পদ উপলব্ধ নেই

সম্পদ প্যাক সম্পর্কে ডাউনলোড তথ্য পান

কোটলিন

suspend fun requestPackStates(packNames: List<String>): AssetPackStates

জাভা

Task<AssetPackStates> getPackStates(List<String> packNames)

কোটলিন

AssetPackStates#packStates(): Map<String, AssetPackState>

জাভা

Map<String, AssetPackState> AssetPackStates#packStates()

চূড়ান্ত অনুরোধ নিম্নলিখিত দ্বারা দেখানো হয়:

কোটলিন

const val assetPackName = "assetPackName"
coroutineScope.launch {
  try {
    val assetPackStates: AssetPackStates =
      manager.requestPackStates(listOf(assetPackName))
    val assetPackState: AssetPackState =
      assetPackStates.packStates()[assetPackName]
  } catch (e: RuntimeExecutionException) {
    Log.d("MainActivity", e.message)
  }
}

জাভা

final String assetPackName = "myasset";

assetPackManager
    .getPackStates(Collections.singletonList(assetPackName))
    .addOnCompleteListener(new OnCompleteListener<AssetPackStates>() {
        @Override
        public void onComplete(Task<AssetPackStates> task) {
            AssetPackStates assetPackStates;
            try {
                assetPackStates = task.getResult();
                AssetPackState assetPackState =
                    assetPackStates.packStates().get(assetPackName);
            } catch (RuntimeExecutionException e) {
                Log.d("MainActivity", e.getMessage());
                return;
            })

ইনস্টল করুন

কোটলিন

suspend fun AssetPackManager.requestFetch(packs: List<String>): AssetPackStates

জাভা

Task<AssetPackStates> fetch(List<String> packNames)

ডাউনলোড স্টেট মনিটর

কোটলিন

fun registerListener(listener: AssetPackStateUpdatedListener)
fun unregisterListener(listener: AssetPackStateUpdatedListener)

জাভা

void registerListener(AssetPackStateUpdatedListener listener)
void unregisterListener(AssetPackStateUpdatedListener listener)

দ্রষ্টব্য: ব্যবহারকারী অ্যাপটি ইনস্টল বা আপডেট করার পরে প্লে স্টোর স্বয়ংক্রিয়ভাবে যেকোনো fast-follow প্যাক ডাউনলোড শুরু করে। যাইহোক, এই প্যাকগুলি অবিলম্বে ব্যবহারের জন্য প্রস্তুত নাও হতে পারে। প্রতিটি অ্যাপ লঞ্চের সময় আপনাকে অবশ্যই fast-follow প্যাকগুলির স্থিতি পরীক্ষা করতে হবে। ডাউনলোড চলমান থাকলে, একজন শ্রোতার সাথে এটি পর্যবেক্ষণ করুন। যদি ডাউনলোডটি বাতিল বা বিরাম দেওয়া হয়, তাহলে আপনি এটিকে পুনরায় শুরু করতে পারেন fetch() পদ্ধতি ব্যবহার করে, যেমনটি ইনস্টল বিভাগে কভার করা আছে।

বড় ডাউনলোড

প্রয়োজনীয় ব্যবহারকারী নিশ্চিতকরণ

নিম্নলিখিত একটি শ্রোতা বাস্তবায়ন একটি উদাহরণ:

কোটলিন

private val activityResultLauncher = registerForActivityResult(
    ActivityResultContracts.StartIntentSenderForResult()
) { result ->
    if (result.resultCode == RESULT_OK) {
        Log.d(TAG, "Confirmation dialog has been accepted.")
    } else if (result.resultCode == RESULT_CANCELED) {
        Log.d(TAG, "Confirmation dialog has been denied by the user.")
    }
}

assetPackManager.registerListener { assetPackState ->
  when(assetPackState.status()) {
    AssetPackStatus.PENDING -> {
      Log.i(TAG, "Pending")
    }
    AssetPackStatus.DOWNLOADING -> {
      val downloaded = assetPackState.bytesDownloaded()
      val totalSize = assetPackState.totalBytesToDownload()
      val percent = 100.0 * downloaded / totalSize

      Log.i(TAG, "PercentDone=" + String.format("%.2f", percent))
    }
    AssetPackStatus.TRANSFERRING -> {
      // 100% downloaded and assets are being transferred.
      // Notify user to wait until transfer is complete.
    }
    AssetPackStatus.COMPLETED -> {
      // Asset pack is ready to use. Start the game.
    }
    AssetPackStatus.FAILED -> {
      // Request failed. Notify user.
      Log.e(TAG, assetPackState.errorCode())
    }
    AssetPackStatus.CANCELED -> {
      // Request canceled. Notify user.
    }
    AssetPackStatus.WAITING_FOR_WIFI,
    AssetPackStatus.REQUIRES_USER_CONFIRMATION -> {
      if (!confirmationDialogShown) {
        assetPackManager.showConfirmationDialog(activityResultLauncher);
        confirmationDialogShown = true
      }
    }
    AssetPackStatus.NOT_INSTALLED -> {
      // Asset pack is not downloaded yet.
    }
    AssetPackStatus.UNKNOWN -> {
      Log.wtf(TAG, "Asset pack status unknown")
    }
  }
}

জাভা

assetPackStateUpdateListener = new AssetPackStateUpdateListener() {
    private final ActivityResultLauncher<IntentSenderRequest> activityResultLauncher =
      registerForActivityResult(
          new ActivityResultContracts.StartIntentSenderForResult(),
          new ActivityResultCallback<ActivityResult>() {
            @Override
            public void onActivityResult(ActivityResult result) {
              if (result.getResultCode() == RESULT_OK) {
                Log.d(TAG, "Confirmation dialog has been accepted.");
              } else if (result.getResultCode() == RESULT_CANCELED) {
                Log.d(TAG, "Confirmation dialog has been denied by the user.");
              }
            }
          });

    @Override
    public void onStateUpdate(AssetPackState assetPackState) {
      switch (assetPackState.status()) {
        case AssetPackStatus.PENDING:
          Log.i(TAG, "Pending");
          break;

        case AssetPackStatus.DOWNLOADING:
          long downloaded = assetPackState.bytesDownloaded();
          long totalSize = assetPackState.totalBytesToDownload();
          double percent = 100.0 * downloaded / totalSize;

          Log.i(TAG, "PercentDone=" + String.format("%.2f", percent));
          break;

        case AssetPackStatus.TRANSFERRING:
          // 100% downloaded and assets are being transferred.
          // Notify user to wait until transfer is complete.
          break;

        case AssetPackStatus.COMPLETED:
          // Asset pack is ready to use. Start the game.
          break;

        case AssetPackStatus.FAILED:
          // Request failed. Notify user.
          Log.e(TAG, assetPackState.errorCode());
          break;

        case AssetPackStatus.CANCELED:
          // Request canceled. Notify user.
          break;

        case AssetPackStatus.WAITING_FOR_WIFI:
        case AssetPackStatus.REQUIRES_USER_CONFIRMATION:
          if (!confirmationDialogShown) {
            assetPackManager.showConfirmationDialog(activityResultLauncher);
            confirmationDialogShown = true;
          }
          break;

        case AssetPackStatus.NOT_INSTALLED:
          // Asset pack is not downloaded yet.
          break;
        case AssetPackStatus.UNKNOWN:
          Log.wtf(TAG, "Asset pack status unknown")
          break;
      }
    }
}

অ্যাসেট প্যাকগুলি অ্যাক্সেস করুন

কোটলিন

private fun getAbsoluteAssetPath(assetPack: String, relativeAssetPath: String): String? {
    val assetPackPath: AssetPackLocation =
      assetPackManager.getPackLocation(assetPack)
      // asset pack is not ready
      ?: return null

    val assetsFolderPath = assetPackPath.assetsPath()
    // equivalent to: FilenameUtils.concat(assetPackPath.path(), "assets")
    return FilenameUtils.concat(assetsFolderPath, relativeAssetPath)
}

জাভা

private String getAbsoluteAssetPath(String assetPack, String relativeAssetPath) {
    AssetPackLocation assetPackPath = assetPackManager.getPackLocation(assetPack);

    if (assetPackPath == null) {
        // asset pack is not ready
        return null;
    }

    String assetsFolderPath = assetPackPath.assetsPath();
    // equivalent to: FilenameUtils.concat(assetPackPath.path(), "assets");
    String assetPath = FilenameUtils.concat(assetsFolderPath, relativeAssetPath);
    return assetPath;
}

অন্যান্য Play সম্পদ বিতরণ API পদ্ধতি

অনুরোধ বাতিল করুন

একটি সম্পদ প্যাক সরান

একটি সম্পদ প্যাক অপসারণের সময়সূচী করতে requestRemovePack() বা removePack() ব্যবহার করুন।

একাধিক সম্পদ প্যাকের অবস্থান পান

পরবর্তী ধাপ

স্থানীয়ভাবে এবং Google Play থেকে প্লে অ্যাসেট ডেলিভারি পরীক্ষা করুন ।

কোটলিন এবং জাভার জন্য তৈরি করুন

আপনার প্রজেক্টের build.gradle ফাইলে Android Gradle প্লাগইনের সংস্করণটি 4.0.0 বা তার পরবর্তী সংস্করণে আপডেট করুন।
আপনার প্রকল্পের শীর্ষ-স্তরের ডিরেক্টরিতে, সম্পদ প্যাকের জন্য একটি ডিরেক্টরি তৈরি করুন। এই ডিরেক্টরির নামটি সম্পদ প্যাক নাম হিসাবে ব্যবহৃত হয়। অ্যাসেট প্যাকের নাম অবশ্যই একটি অক্ষর দিয়ে শুরু করতে হবে এবং এতে শুধুমাত্র অক্ষর, সংখ্যা এবং আন্ডারস্কোর থাকতে পারে।

গ্রোভি

// In the asset pack's build.gradle file:
plugins {
  id 'com.android.asset-pack'
}

assetPack {
    packName = "asset-pack-name" // Directory name for the asset pack
    dynamicDelivery {
        deliveryType = "[ install-time | fast-follow | on-demand ]"
    }
}

কোটলিন

// In the asset pack's build.gradle.kts file:
plugins {
  id("com.android.asset-pack")
}

assetPack {
  packName.set("asset-pack-name") // Directory name for the asset pack
  dynamicDelivery {
    deliveryType.set("[ install-time | fast-follow | on-demand ]")
  }
}

প্রজেক্টের অ্যাপ build.gradle ফাইলে, নিচে দেখানো হিসাবে আপনার প্রোজেক্টের প্রতিটি অ্যাসেট প্যাকের নাম যোগ করুন:
গ্রোভি
```
// In the app build.gradle file:
android {
    ...
    assetPacks = [":asset-pack-name", ":asset-pack2-name"]
}
```
কোটলিন
```
// In the app build.gradle.kts file:
android {
    ...
    assetPacks += listOf(":asset-pack-name", ":asset-pack2-name")
}
```
প্রজেক্টের settings.gradle ফাইলে, নিচের মত আপনার প্রোজেক্টের সমস্ত অ্যাসেট প্যাক অন্তর্ভুক্ত করুন:
গ্রোভি
```
// In the settings.gradle file:
include ':app'
include ':asset-pack-name'
include ':asset-pack2-name'
```
কোটলিন
```
// In the settings.gradle.kts file:
include(":app")
include(":asset-pack-name")
include(":asset-pack2-name")
```
সম্পদ প্যাক ডিরেক্টরিতে, নিম্নলিখিত সাবডিরেক্টরি তৈরি করুন: src/main/assets
src/main/assets ডিরেক্টরিতে সম্পদ রাখুন। আপনি এখানেও সাবডিরেক্টরি তৈরি করতে পারেন। আপনার অ্যাপ্লিকেশানের জন্য ডিরেক্টরি কাঠামোটি এখন নিম্নলিখিতগুলির মতো হওয়া উচিত:
- build.gradle
- settings.gradle
- app/
- asset-pack-name /build.gradle
- asset-pack-name /src/main/assets/ your-asset-directories
Gradle এর সাথে Android অ্যাপ বান্ডেল তৈরি করুন । জেনারেট করা অ্যাপ বান্ডেলে, রুট-লেভেল ডিরেক্টরিতে এখন নিম্নলিখিতগুলি অন্তর্ভুক্ত রয়েছে:
- asset-pack-name /manifest/AndroidManifest.xml : সম্পদ প্যাকের শনাক্তকারী এবং বিতরণ মোড কনফিগার করে
- asset-pack-name /assets/ your-asset-directories : যে ডিরেক্টরিতে সম্পদ প্যাকের অংশ হিসাবে বিতরণ করা সমস্ত সম্পদ রয়েছে
Gradle প্রতিটি সম্পদ প্যাকের জন্য ম্যানিফেস্ট তৈরি করে এবং আপনার জন্য assets/ ডিরেক্টরি আউটপুট করে।
(ঐচ্ছিক) যদি আপনি দ্রুত-অনুসরণ এবং অন-ডিমান্ড ডেলিভারি ব্যবহার করার পরিকল্পনা করেন তাহলে প্লে অ্যাসেট ডেলিভারি লাইব্রেরি অন্তর্ভুক্ত করুন
গ্রোভি
```
implementation "com.google.android.play:asset-delivery:2.2.2"
// For Kotlin use asset-delivery-ktx
implementation "com.google.android.play:asset-delivery-ktx:2.2.2"
```
কোটলিন
```
implementation("com.google.android.play:asset-delivery:2.2.2")
// For Kotlin use core-ktx
implementation("com.google.android.play:asset-delivery-ktx:2.2.2")
```
(ঐচ্ছিক) বিভিন্ন টেক্সচার কম্প্রেশন ফর্ম্যাট সমর্থন করতে আপনার অ্যাপ বান্ডেল কনফিগার করুন।

Play Asset Delivery API-এর সাথে একীভূত করুন

জাভা প্রোগ্রামিং ভাষার জন্য সম্পদ প্যাক প্রবাহ চিত্র

চিত্র 1. অ্যাসেট প্যাকগুলি অ্যাক্সেস করার জন্য ফ্লো ডায়াগ্রাম৷

ইন্সটল-টাইম ডেলিভারি

কোটলিন

import android.content.res.AssetManager
...
val context: Context = createPackageContext("com.example.app", 0)
val assetManager: AssetManager = context.assets
val stream: InputStream = assetManager.open("asset-name")

জাভা

import android.content.res.AssetManager;
...
Context context = createPackageContext("com.example.app", 0);
AssetManager assetManager = context.getAssets();
InputStream is = assetManager.open("asset-name");

দ্রুত-অনুসরণ এবং অন-ডিমান্ড ডেলিভারি

স্থিতি পরীক্ষা করুন

রিটার্ন মান	স্ট্যাটাস
একটি বৈধ `AssetPackLocation` অবজেক্ট	সম্পদ প্যাক রুট ফোল্ডার `assetsPath()` এ অবিলম্বে অ্যাক্সেসের জন্য প্রস্তুত
`null`	অজানা সম্পদ প্যাক বা সম্পদ উপলব্ধ নেই

সম্পদ প্যাক সম্পর্কে ডাউনলোড তথ্য পান

কোটলিন

suspend fun requestPackStates(packNames: List<String>): AssetPackStates

জাভা

Task<AssetPackStates> getPackStates(List<String> packNames)

কোটলিন

AssetPackStates#packStates(): Map<String, AssetPackState>

জাভা

Map<String, AssetPackState> AssetPackStates#packStates()

চূড়ান্ত অনুরোধ নিম্নলিখিত দ্বারা দেখানো হয়:

কোটলিন

const val assetPackName = "assetPackName"
coroutineScope.launch {
  try {
    val assetPackStates: AssetPackStates =
      manager.requestPackStates(listOf(assetPackName))
    val assetPackState: AssetPackState =
      assetPackStates.packStates()[assetPackName]
  } catch (e: RuntimeExecutionException) {
    Log.d("MainActivity", e.message)
  }
}

জাভা

final String assetPackName = "myasset";

assetPackManager
    .getPackStates(Collections.singletonList(assetPackName))
    .addOnCompleteListener(new OnCompleteListener<AssetPackStates>() {
        @Override
        public void onComplete(Task<AssetPackStates> task) {
            AssetPackStates assetPackStates;
            try {
                assetPackStates = task.getResult();
                AssetPackState assetPackState =
                    assetPackStates.packStates().get(assetPackName);
            } catch (RuntimeExecutionException e) {
                Log.d("MainActivity", e.getMessage());
                return;
            })

ইনস্টল করুন

কোটলিন

suspend fun AssetPackManager.requestFetch(packs: List<String>): AssetPackStates

জাভা

Task<AssetPackStates> fetch(List<String> packNames)

ডাউনলোড স্টেট মনিটর

কোটলিন

fun registerListener(listener: AssetPackStateUpdatedListener)
fun unregisterListener(listener: AssetPackStateUpdatedListener)

জাভা

void registerListener(AssetPackStateUpdatedListener listener)
void unregisterListener(AssetPackStateUpdatedListener listener)

দ্রষ্টব্য: ব্যবহারকারী অ্যাপটি ইনস্টল বা আপডেট করার পরে প্লে স্টোর স্বয়ংক্রিয়ভাবে যেকোনো fast-follow প্যাক ডাউনলোড শুরু করে। যাইহোক, এই প্যাকগুলি অবিলম্বে ব্যবহারের জন্য প্রস্তুত নাও হতে পারে। প্রতিটি অ্যাপ লঞ্চের সময় আপনাকে অবশ্যই fast-follow প্যাকগুলির স্থিতি পরীক্ষা করতে হবে। ডাউনলোড চলমান থাকলে, একজন শ্রোতার সাথে এটি পর্যবেক্ষণ করুন। যদি ডাউনলোডটি বাতিল বা বিরাম দেওয়া হয়, তাহলে আপনি এটিকে পুনরায় শুরু করতে পারেন fetch() পদ্ধতি ব্যবহার করে, যেমনটি ইনস্টল বিভাগে কভার করা আছে।

বড় ডাউনলোড

প্রয়োজনীয় ব্যবহারকারী নিশ্চিতকরণ

নিম্নলিখিত একটি শ্রোতা বাস্তবায়ন একটি উদাহরণ:

কোটলিন

private val activityResultLauncher = registerForActivityResult(
    ActivityResultContracts.StartIntentSenderForResult()
) { result ->
    if (result.resultCode == RESULT_OK) {
        Log.d(TAG, "Confirmation dialog has been accepted.")
    } else if (result.resultCode == RESULT_CANCELED) {
        Log.d(TAG, "Confirmation dialog has been denied by the user.")
    }
}

assetPackManager.registerListener { assetPackState ->
  when(assetPackState.status()) {
    AssetPackStatus.PENDING -> {
      Log.i(TAG, "Pending")
    }
    AssetPackStatus.DOWNLOADING -> {
      val downloaded = assetPackState.bytesDownloaded()
      val totalSize = assetPackState.totalBytesToDownload()
      val percent = 100.0 * downloaded / totalSize

      Log.i(TAG, "PercentDone=" + String.format("%.2f", percent))
    }
    AssetPackStatus.TRANSFERRING -> {
      // 100% downloaded and assets are being transferred.
      // Notify user to wait until transfer is complete.
    }
    AssetPackStatus.COMPLETED -> {
      // Asset pack is ready to use. Start the game.
    }
    AssetPackStatus.FAILED -> {
      // Request failed. Notify user.
      Log.e(TAG, assetPackState.errorCode())
    }
    AssetPackStatus.CANCELED -> {
      // Request canceled. Notify user.
    }
    AssetPackStatus.WAITING_FOR_WIFI,
    AssetPackStatus.REQUIRES_USER_CONFIRMATION -> {
      if (!confirmationDialogShown) {
        assetPackManager.showConfirmationDialog(activityResultLauncher);
        confirmationDialogShown = true
      }
    }
    AssetPackStatus.NOT_INSTALLED -> {
      // Asset pack is not downloaded yet.
    }
    AssetPackStatus.UNKNOWN -> {
      Log.wtf(TAG, "Asset pack status unknown")
    }
  }
}

জাভা

assetPackStateUpdateListener = new AssetPackStateUpdateListener() {
    private final ActivityResultLauncher<IntentSenderRequest> activityResultLauncher =
      registerForActivityResult(
          new ActivityResultContracts.StartIntentSenderForResult(),
          new ActivityResultCallback<ActivityResult>() {
            @Override
            public void onActivityResult(ActivityResult result) {
              if (result.getResultCode() == RESULT_OK) {
                Log.d(TAG, "Confirmation dialog has been accepted.");
              } else if (result.getResultCode() == RESULT_CANCELED) {
                Log.d(TAG, "Confirmation dialog has been denied by the user.");
              }
            }
          });

    @Override
    public void onStateUpdate(AssetPackState assetPackState) {
      switch (assetPackState.status()) {
        case AssetPackStatus.PENDING:
          Log.i(TAG, "Pending");
          break;

        case AssetPackStatus.DOWNLOADING:
          long downloaded = assetPackState.bytesDownloaded();
          long totalSize = assetPackState.totalBytesToDownload();
          double percent = 100.0 * downloaded / totalSize;

          Log.i(TAG, "PercentDone=" + String.format("%.2f", percent));
          break;

        case AssetPackStatus.TRANSFERRING:
          // 100% downloaded and assets are being transferred.
          // Notify user to wait until transfer is complete.
          break;

        case AssetPackStatus.COMPLETED:
          // Asset pack is ready to use. Start the game.
          break;

        case AssetPackStatus.FAILED:
          // Request failed. Notify user.
          Log.e(TAG, assetPackState.errorCode());
          break;

        case AssetPackStatus.CANCELED:
          // Request canceled. Notify user.
          break;

        case AssetPackStatus.WAITING_FOR_WIFI:
        case AssetPackStatus.REQUIRES_USER_CONFIRMATION:
          if (!confirmationDialogShown) {
            assetPackManager.showConfirmationDialog(activityResultLauncher);
            confirmationDialogShown = true;
          }
          break;

        case AssetPackStatus.NOT_INSTALLED:
          // Asset pack is not downloaded yet.
          break;
        case AssetPackStatus.UNKNOWN:
          Log.wtf(TAG, "Asset pack status unknown")
          break;
      }
    }
}

অ্যাসেট প্যাকগুলি অ্যাক্সেস করুন

কোটলিন

private fun getAbsoluteAssetPath(assetPack: String, relativeAssetPath: String): String? {
    val assetPackPath: AssetPackLocation =
      assetPackManager.getPackLocation(assetPack)
      // asset pack is not ready
      ?: return null

    val assetsFolderPath = assetPackPath.assetsPath()
    // equivalent to: FilenameUtils.concat(assetPackPath.path(), "assets")
    return FilenameUtils.concat(assetsFolderPath, relativeAssetPath)
}

জাভা

private String getAbsoluteAssetPath(String assetPack, String relativeAssetPath) {
    AssetPackLocation assetPackPath = assetPackManager.getPackLocation(assetPack);

    if (assetPackPath == null) {
        // asset pack is not ready
        return null;
    }

    String assetsFolderPath = assetPackPath.assetsPath();
    // equivalent to: FilenameUtils.concat(assetPackPath.path(), "assets");
    String assetPath = FilenameUtils.concat(assetsFolderPath, relativeAssetPath);
    return assetPath;
}

অন্যান্য Play সম্পদ বিতরণ API পদ্ধতি

অনুরোধ বাতিল করুন

একটি সম্পদ প্যাক সরান

একটি সম্পদ প্যাক অপসারণের সময়সূচী করতে requestRemovePack() বা removePack() ব্যবহার করুন।

একাধিক সম্পদ প্যাকের অবস্থান পান

পরবর্তী ধাপ

স্থানীয়ভাবে এবং Google Play থেকে প্লে অ্যাসেট ডেলিভারি পরীক্ষা করুন ।

কোটলিন এবং জাভার জন্য তৈরি করুন

আপনার প্রজেক্টের build.gradle ফাইলে Android Gradle প্লাগইনের সংস্করণটি 4.0.0 বা তার পরবর্তী সংস্করণে আপডেট করুন।
আপনার প্রকল্পের শীর্ষ-স্তরের ডিরেক্টরিতে, সম্পদ প্যাকের জন্য একটি ডিরেক্টরি তৈরি করুন। এই ডিরেক্টরির নামটি সম্পদ প্যাক নাম হিসাবে ব্যবহৃত হয়। অ্যাসেট প্যাকের নাম অবশ্যই একটি অক্ষর দিয়ে শুরু করতে হবে এবং এতে শুধুমাত্র অক্ষর, সংখ্যা এবং আন্ডারস্কোর থাকতে পারে।

গ্রোভি

// In the asset pack's build.gradle file:
plugins {
  id 'com.android.asset-pack'
}

assetPack {
    packName = "asset-pack-name" // Directory name for the asset pack
    dynamicDelivery {
        deliveryType = "[ install-time | fast-follow | on-demand ]"
    }
}

কোটলিন

// In the asset pack's build.gradle.kts file:
plugins {
  id("com.android.asset-pack")
}

assetPack {
  packName.set("asset-pack-name") // Directory name for the asset pack
  dynamicDelivery {
    deliveryType.set("[ install-time | fast-follow | on-demand ]")
  }
}

প্রজেক্টের অ্যাপ build.gradle ফাইলে, আপনার প্রোজেক্টের প্রতিটি অ্যাসেট প্যাকের নাম নিচে দেখানো মত যোগ করুন:
গ্রোভি
```
// In the app build.gradle file:
android {
    ...
    assetPacks = [":asset-pack-name", ":asset-pack2-name"]
}
```
কোটলিন
```
// In the app build.gradle.kts file:
android {
    ...
    assetPacks += listOf(":asset-pack-name", ":asset-pack2-name")
}
```
প্রজেক্টের settings.gradle ফাইলে, নিচের মত আপনার প্রোজেক্টের সমস্ত অ্যাসেট প্যাক অন্তর্ভুক্ত করুন:
গ্রোভি
```
// In the settings.gradle file:
include ':app'
include ':asset-pack-name'
include ':asset-pack2-name'
```
কোটলিন
```
// In the settings.gradle.kts file:
include(":app")
include(":asset-pack-name")
include(":asset-pack2-name")
```
সম্পদ প্যাক ডিরেক্টরিতে, নিম্নলিখিত সাবডিরেক্টরি তৈরি করুন: src/main/assets
src/main/assets ডিরেক্টরিতে সম্পদ রাখুন। আপনি এখানেও সাবডিরেক্টরি তৈরি করতে পারেন। আপনার অ্যাপ্লিকেশানের জন্য ডিরেক্টরি কাঠামোটি এখন নিম্নলিখিতগুলির মতো হওয়া উচিত:
- build.gradle
- settings.gradle
- app/
- asset-pack-name /build.gradle
- asset-pack-name /src/main/assets/ your-asset-directories
Gradle এর সাথে Android অ্যাপ বান্ডেল তৈরি করুন । জেনারেট করা অ্যাপ বান্ডেলে, রুট-লেভেল ডিরেক্টরিতে এখন নিম্নলিখিতগুলি অন্তর্ভুক্ত রয়েছে:
- asset-pack-name /manifest/AndroidManifest.xml : সম্পদ প্যাকের শনাক্তকারী এবং বিতরণ মোড কনফিগার করে
- asset-pack-name /assets/ your-asset-directories : যে ডিরেক্টরিতে সম্পদ প্যাকের অংশ হিসাবে বিতরণ করা সমস্ত সম্পদ রয়েছে
Gradle প্রতিটি সম্পদ প্যাকের জন্য ম্যানিফেস্ট তৈরি করে এবং আপনার জন্য assets/ ডিরেক্টরি আউটপুট করে।
(ঐচ্ছিক) যদি আপনি দ্রুত-অনুসরণ এবং অন-ডিমান্ড ডেলিভারি ব্যবহার করার পরিকল্পনা করেন তাহলে প্লে অ্যাসেট ডেলিভারি লাইব্রেরি অন্তর্ভুক্ত করুন
গ্রোভি
```
implementation "com.google.android.play:asset-delivery:2.2.2"
// For Kotlin use asset-delivery-ktx
implementation "com.google.android.play:asset-delivery-ktx:2.2.2"
```
কোটলিন
```
implementation("com.google.android.play:asset-delivery:2.2.2")
// For Kotlin use core-ktx
implementation("com.google.android.play:asset-delivery-ktx:2.2.2")
```
(ঐচ্ছিক) বিভিন্ন টেক্সচার কম্প্রেশন ফর্ম্যাট সমর্থন করতে আপনার অ্যাপ বান্ডেল কনফিগার করুন।

Play Asset Delivery API-এর সাথে একীভূত করুন

জাভা প্রোগ্রামিং ভাষার জন্য সম্পদ প্যাক প্রবাহ চিত্র

চিত্র 1. অ্যাসেট প্যাকগুলি অ্যাক্সেস করার জন্য ফ্লো ডায়াগ্রাম৷

ইন্সটল-টাইম ডেলিভারি

কোটলিন

import android.content.res.AssetManager
...
val context: Context = createPackageContext("com.example.app", 0)
val assetManager: AssetManager = context.assets
val stream: InputStream = assetManager.open("asset-name")

জাভা

import android.content.res.AssetManager;
...
Context context = createPackageContext("com.example.app", 0);
AssetManager assetManager = context.getAssets();
InputStream is = assetManager.open("asset-name");

দ্রুত-অনুসরণ এবং অন-ডিমান্ড ডেলিভারি

স্থিতি পরীক্ষা করুন

রিটার্ন মান	স্ট্যাটাস
একটি বৈধ `AssetPackLocation` অবজেক্ট	সম্পদ প্যাক রুট ফোল্ডার `assetsPath()` এ অবিলম্বে অ্যাক্সেসের জন্য প্রস্তুত
`null`	অজানা সম্পদ প্যাক বা সম্পদ উপলব্ধ নেই

সম্পদ প্যাক সম্পর্কে ডাউনলোড তথ্য পান

কোটলিন

suspend fun requestPackStates(packNames: List<String>): AssetPackStates

জাভা

Task<AssetPackStates> getPackStates(List<String> packNames)

কোটলিন

AssetPackStates#packStates(): Map<String, AssetPackState>

জাভা

Map<String, AssetPackState> AssetPackStates#packStates()

চূড়ান্ত অনুরোধ নিম্নলিখিত দ্বারা দেখানো হয়:

কোটলিন

const val assetPackName = "assetPackName"
coroutineScope.launch {
  try {
    val assetPackStates: AssetPackStates =
      manager.requestPackStates(listOf(assetPackName))
    val assetPackState: AssetPackState =
      assetPackStates.packStates()[assetPackName]
  } catch (e: RuntimeExecutionException) {
    Log.d("MainActivity", e.message)
  }
}

জাভা

final String assetPackName = "myasset";

assetPackManager
    .getPackStates(Collections.singletonList(assetPackName))
    .addOnCompleteListener(new OnCompleteListener<AssetPackStates>() {
        @Override
        public void onComplete(Task<AssetPackStates> task) {
            AssetPackStates assetPackStates;
            try {
                assetPackStates = task.getResult();
                AssetPackState assetPackState =
                    assetPackStates.packStates().get(assetPackName);
            } catch (RuntimeExecutionException e) {
                Log.d("MainActivity", e.getMessage());
                return;
            })

যদি কোনও অনুরোধ ব্যর্থ হয় তবে errorCode() পদ্ধতিটি ব্যবহার করুন, যার রিটার্ন মানটি AssetPackErrorCode শ্রেণিতে একটি ধ্রুবক ক্ষেত্রের সাথে মিলে যায়।

ইনস্টল করুন

প্রথমবারের জন্য একটি সম্পদ প্যাক ডাউনলোড করতে requestFetch() বা fetch() পদ্ধতিটি ব্যবহার করুন বা সম্পদ প্যাকটি সম্পূর্ণ করার জন্য কল করুন:

কোটলিন

suspend fun AssetPackManager.requestFetch(packs: List<String>): AssetPackStates

জাভা

Task<AssetPackStates> fetch(List<String> packNames)

এই পদ্ধতিটি প্যাকগুলির একটি তালিকা এবং তাদের প্রাথমিক ডাউনলোডের রাজ্য এবং আকারযুক্ত একটি AssetPackStates অবজেক্টকে প্রদান করে। যদি কোনও সম্পদ প্যাকটি requestFetch() বা fetch() এর মাধ্যমে অনুরোধ করা হয় তবে ইতিমধ্যে ডাউনলোডের স্থিতি ফিরে আসে এবং কোনও অতিরিক্ত ডাউনলোড শুরু হয় না।

ডাউনলোড রাজ্যগুলি মনিটর করুন

সম্পদ প্যাকগুলির ইনস্টলেশন অগ্রগতি ট্র্যাক করতে আপনার একটি AssetPackStateUpdatedListener প্রয়োগ করা উচিত। পৃথক সম্পদ প্যাকগুলির স্থিতি ট্র্যাকিং সমর্থন করার জন্য প্রতি প্যাক প্রতি স্থিতি আপডেটগুলি ভেঙে দেওয়া হয়। আপনার অনুরোধের জন্য অন্যান্য সমস্ত ডাউনলোড শেষ হওয়ার আগে আপনি উপলভ্য সম্পদ প্যাকগুলি ব্যবহার শুরু করতে পারেন।

কোটলিন

fun registerListener(listener: AssetPackStateUpdatedListener)
fun unregisterListener(listener: AssetPackStateUpdatedListener)

জাভা

void registerListener(AssetPackStateUpdatedListener listener)
void unregisterListener(AssetPackStateUpdatedListener listener)

দ্রষ্টব্য: প্লে স্টোরটি ব্যবহারকারী অ্যাপটি ইনস্টল বা আপডেট করার পরে স্বয়ংক্রিয়ভাবে কোনও fast-follow প্যাকগুলি ডাউনলোড করতে ট্রিগার করে। তবে এই প্যাকগুলি অবিলম্বে ব্যবহার করতে প্রস্তুত নাও হতে পারে। আপনাকে অবশ্যই প্রতিটি অ্যাপ্লিকেশন লঞ্চে fast-follow প্যাকগুলির স্থিতি পরীক্ষা করতে হবে। যদি ডাউনলোডটি অগ্রগতিতে থাকে তবে শ্রোতার সাথে এটি পর্যবেক্ষণ করুন। যদি ডাউনলোডটি বাতিল বা বিরতি দেওয়া হয় তবে আপনি ইনস্টল বিভাগে আচ্ছাদিত হিসাবে fetch() পদ্ধতিটি ব্যবহার করে এটি আবার শুরু করতে পারেন।

বড় ডাউনলোড

যদি ডাউনলোডটি 200 এমবি-র চেয়ে বড় হয় এবং ব্যবহারকারী ওয়াই-ফাইতে না থাকে তবে ব্যবহারকারী স্পষ্টভাবে মোবাইল ডেটা সংযোগ ব্যবহার করে ডাউনলোডের সাথে এগিয়ে যাওয়ার সম্মতি না দেওয়া পর্যন্ত ডাউনলোড শুরু হয় না। একইভাবে, যদি ডাউনলোডটি বড় হয় এবং ব্যবহারকারী ওয়াই-ফাই হারাতে থাকে তবে ডাউনলোডটি বিরতি দেওয়া হয় এবং একটি মোবাইল ডেটা সংযোগ ব্যবহার করে এগিয়ে যাওয়ার জন্য সুস্পষ্ট সম্মতি প্রয়োজন। একটি বিরতিযুক্ত প্যাকটিতে স্টেট WAITING_FOR_WIFI রয়েছে। ইউআই প্রবাহকে ট্রিগার করতে ব্যবহারকারীকে সম্মতির জন্য অনুরোধ করতে, showConfirmationDialog() পদ্ধতিটি ব্যবহার করুন।

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

প্রয়োজনীয় ব্যবহারকারী নিশ্চিতকরণ

যদি কোনও প্যাকের REQUIRES_USER_CONFIRMATION স্ট্যাটাস থাকে তবে ব্যবহারকারী showConfirmationDialog() এর সাথে প্রদর্শিত ডায়ালগটি গ্রহণ না করা পর্যন্ত ডাউনলোডটি এগিয়ে যাবে না। যখন অ্যাপটি প্লে দ্বারা স্বীকৃত না হয় তখন এই অবস্থাটি ঘটতে পারে example উদাহরণস্বরূপ, যদি অ্যাপটি পাশ-লোড হয়। নোট করুন যে এই ক্ষেত্রে showConfirmationDialog() কল করা অ্যাপটি আপডেট করা হবে। আপডেটের পরে, আপনাকে আবার সম্পদের অনুরোধ করতে হবে।

নিম্নলিখিত শ্রোতার একটি উদাহরণ বাস্তবায়ন:

কোটলিন

private val activityResultLauncher = registerForActivityResult(
    ActivityResultContracts.StartIntentSenderForResult()
) { result ->
    if (result.resultCode == RESULT_OK) {
        Log.d(TAG, "Confirmation dialog has been accepted.")
    } else if (result.resultCode == RESULT_CANCELED) {
        Log.d(TAG, "Confirmation dialog has been denied by the user.")
    }
}

assetPackManager.registerListener { assetPackState ->
  when(assetPackState.status()) {
    AssetPackStatus.PENDING -> {
      Log.i(TAG, "Pending")
    }
    AssetPackStatus.DOWNLOADING -> {
      val downloaded = assetPackState.bytesDownloaded()
      val totalSize = assetPackState.totalBytesToDownload()
      val percent = 100.0 * downloaded / totalSize

      Log.i(TAG, "PercentDone=" + String.format("%.2f", percent))
    }
    AssetPackStatus.TRANSFERRING -> {
      // 100% downloaded and assets are being transferred.
      // Notify user to wait until transfer is complete.
    }
    AssetPackStatus.COMPLETED -> {
      // Asset pack is ready to use. Start the game.
    }
    AssetPackStatus.FAILED -> {
      // Request failed. Notify user.
      Log.e(TAG, assetPackState.errorCode())
    }
    AssetPackStatus.CANCELED -> {
      // Request canceled. Notify user.
    }
    AssetPackStatus.WAITING_FOR_WIFI,
    AssetPackStatus.REQUIRES_USER_CONFIRMATION -> {
      if (!confirmationDialogShown) {
        assetPackManager.showConfirmationDialog(activityResultLauncher);
        confirmationDialogShown = true
      }
    }
    AssetPackStatus.NOT_INSTALLED -> {
      // Asset pack is not downloaded yet.
    }
    AssetPackStatus.UNKNOWN -> {
      Log.wtf(TAG, "Asset pack status unknown")
    }
  }
}

জাভা

assetPackStateUpdateListener = new AssetPackStateUpdateListener() {
    private final ActivityResultLauncher<IntentSenderRequest> activityResultLauncher =
      registerForActivityResult(
          new ActivityResultContracts.StartIntentSenderForResult(),
          new ActivityResultCallback<ActivityResult>() {
            @Override
            public void onActivityResult(ActivityResult result) {
              if (result.getResultCode() == RESULT_OK) {
                Log.d(TAG, "Confirmation dialog has been accepted.");
              } else if (result.getResultCode() == RESULT_CANCELED) {
                Log.d(TAG, "Confirmation dialog has been denied by the user.");
              }
            }
          });

    @Override
    public void onStateUpdate(AssetPackState assetPackState) {
      switch (assetPackState.status()) {
        case AssetPackStatus.PENDING:
          Log.i(TAG, "Pending");
          break;

        case AssetPackStatus.DOWNLOADING:
          long downloaded = assetPackState.bytesDownloaded();
          long totalSize = assetPackState.totalBytesToDownload();
          double percent = 100.0 * downloaded / totalSize;

          Log.i(TAG, "PercentDone=" + String.format("%.2f", percent));
          break;

        case AssetPackStatus.TRANSFERRING:
          // 100% downloaded and assets are being transferred.
          // Notify user to wait until transfer is complete.
          break;

        case AssetPackStatus.COMPLETED:
          // Asset pack is ready to use. Start the game.
          break;

        case AssetPackStatus.FAILED:
          // Request failed. Notify user.
          Log.e(TAG, assetPackState.errorCode());
          break;

        case AssetPackStatus.CANCELED:
          // Request canceled. Notify user.
          break;

        case AssetPackStatus.WAITING_FOR_WIFI:
        case AssetPackStatus.REQUIRES_USER_CONFIRMATION:
          if (!confirmationDialogShown) {
            assetPackManager.showConfirmationDialog(activityResultLauncher);
            confirmationDialogShown = true;
          }
          break;

        case AssetPackStatus.NOT_INSTALLED:
          // Asset pack is not downloaded yet.
          break;
        case AssetPackStatus.UNKNOWN:
          Log.wtf(TAG, "Asset pack status unknown")
          break;
      }
    }
}

বিকল্পভাবে, আপনি বর্তমান ডাউনলোডগুলির স্থিতি পেতে getPackStates() পদ্ধতিটি ব্যবহার করতে পারেন। AssetPackStates ডাউনলোডের অগ্রগতি, ডাউনলোডের স্থিতি এবং কোনও ব্যর্থতার ত্রুটি কোড রয়েছে।

অ্যাক্সেস সম্পদ প্যাকগুলি

ডাউনলোডের অনুরোধটি COMPLETED অবস্থায় পৌঁছানোর পরে আপনি ফাইল সিস্টেম কলগুলি ব্যবহার করে একটি সম্পদ প্যাক অ্যাক্সেস করতে পারেন। সম্পদ প্যাকের মূল ফোল্ডারটি পেতে getPackLocation() পদ্ধতিটি ব্যবহার করুন।

সম্পদগুলি সম্পদ প্যাক রুট ডিরেক্টরিতে assets ডিরেক্টরিতে সংরক্ষণ করা হয়। আপনি সুবিধা পদ্ধতি assetsPath() ব্যবহার করে assets ডিরেক্টরিতে পথ পেতে পারেন। একটি নির্দিষ্ট সম্পত্তির পথ পেতে নিম্নলিখিত পদ্ধতিটি ব্যবহার করুন:

কোটলিন

private fun getAbsoluteAssetPath(assetPack: String, relativeAssetPath: String): String? {
    val assetPackPath: AssetPackLocation =
      assetPackManager.getPackLocation(assetPack)
      // asset pack is not ready
      ?: return null

    val assetsFolderPath = assetPackPath.assetsPath()
    // equivalent to: FilenameUtils.concat(assetPackPath.path(), "assets")
    return FilenameUtils.concat(assetsFolderPath, relativeAssetPath)
}

জাভা

private String getAbsoluteAssetPath(String assetPack, String relativeAssetPath) {
    AssetPackLocation assetPackPath = assetPackManager.getPackLocation(assetPack);

    if (assetPackPath == null) {
        // asset pack is not ready
        return null;
    }

    String assetsFolderPath = assetPackPath.assetsPath();
    // equivalent to: FilenameUtils.concat(assetPackPath.path(), "assets");
    String assetPath = FilenameUtils.concat(assetsFolderPath, relativeAssetPath);
    return assetPath;
}

অন্যান্য প্লে সম্পদ বিতরণ এপিআই পদ্ধতি

নিম্নলিখিতগুলি আপনার অ্যাপ্লিকেশনটিতে ব্যবহার করতে চাইতে পারেন এমন কিছু অতিরিক্ত এপিআই পদ্ধতি রয়েছে।

অনুরোধ বাতিল করুন

একটি সক্রিয় সম্পদ প্যাক অনুরোধ বাতিল করতে cancel() ব্যবহার করুন। নোট করুন যে এই অনুরোধটি একটি সেরা-প্রচেষ্টা অপারেশন।

একটি সম্পদ প্যাক সরান

সম্পদ প্যাকটি অপসারণের সময়সূচী করতে requestRemovePack() বা removePack() ব্যবহার করুন।

একাধিক সম্পদ প্যাকগুলির অবস্থান পান

বাল্কে একাধিক সম্পদ প্যাকগুলির স্থিতি জিজ্ঞাসা করতে getPackLocations() ব্যবহার করুন, যা সম্পদ প্যাক এবং তাদের অবস্থানগুলির একটি মানচিত্র প্রদান করে। getPackLocations() দ্বারা ফিরে আসা মানচিত্রে প্রতিটি প্যাকের জন্য একটি এন্ট্রি রয়েছে যা বর্তমানে ডাউনলোড এবং আপ-টু-ডেট রয়েছে।

পরবর্তী ধাপ

স্থানীয়ভাবে এবং গুগল প্লে থেকে টেস্ট প্লে সম্পদ বিতরণ ।