ইন্টিগ্রেট অ্যাসেট ডেলিভারি (নেটিভ)

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

নমুনা ইন্টিগ্রেশন কোড GitHub এ উপলব্ধ।

স্থানীয় জন্য নির্মাণ

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

  1. আপনার প্রজেক্টের build.gradle ফাইলে Android Gradle প্লাগইনের সংস্করণটি 4.0.0 বা তার পরবর্তী সংস্করণে আপডেট করুন।

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

  3. সম্পদ প্যাক ডিরেক্টরিতে, একটি 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 ]"
        }
    }
  4. প্রজেক্টের অ্যাপ build.gradle ফাইলে, আপনার প্রোজেক্টের প্রতিটি অ্যাসেট প্যাকের নাম নিচে দেখানো মত যোগ করুন:

    // In the app build.gradle file:
    android {
        ...
        assetPacks = [":asset-pack-name", ":asset-pack2-name"]
    }
  5. প্রজেক্টের settings.gradle ফাইলে, নিচের মত আপনার প্রোজেক্টের সমস্ত অ্যাসেট প্যাক অন্তর্ভুক্ত করুন:

    // In the settings.gradle file:
    include ':app'
    include ':asset-pack-name'
    include ':asset-pack2-name'
  6. সম্পদ প্যাক ডিরেক্টরিতে, নিম্নলিখিত সাবডিরেক্টরি তৈরি করুন: src/main/assets

  7. src/main/assets ডিরেক্টরিতে সম্পদ রাখুন। আপনি এখানেও সাবডিরেক্টরি তৈরি করতে পারেন। আপনার অ্যাপ্লিকেশানের জন্য ডিরেক্টরি কাঠামোটি এখন নিম্নলিখিতগুলির মতো হওয়া উচিত:

    • build.gradle
    • settings.gradle
    • app/
    • asset-pack-name /build.gradle
    • asset-pack-name /src/main/assets/ your-asset-directories
  8. Gradle এর সাথে Android অ্যাপ বান্ডেল তৈরি করুন । জেনারেট করা অ্যাপ বান্ডেলে, রুট-লেভেল ডিরেক্টরিতে এখন নিম্নলিখিতগুলি অন্তর্ভুক্ত রয়েছে:

    • asset-pack-name /manifest/AndroidManifest.xml : সম্পদ প্যাকের শনাক্তকারী এবং বিতরণ মোড কনফিগার করে
    • asset-pack-name /assets/ your-asset-directories : যে ডিরেক্টরিতে সম্পদ প্যাকের অংশ হিসাবে বিতরণ করা সমস্ত সম্পদ রয়েছে

    Gradle প্রতিটি সম্পদ প্যাকের জন্য ম্যানিফেস্ট তৈরি করে এবং আপনার জন্য assets/ ডিরেক্টরি আউটপুট করে।

  9. (ঐচ্ছিক) বিভিন্ন টেক্সচার কম্প্রেশন ফর্ম্যাট সমর্থন করতে আপনার অ্যাপ বান্ডেল কনফিগার করুন।

প্লে অ্যাসেট ডেলিভারি লাইব্রেরির সাথে ইন্টিগ্রেট করুন

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

নেটিভ কোডের জন্য অ্যাসেট প্যাক ফ্লো ডায়াগ্রাম

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

প্লে কোর নেটিভ SDK অ্যাসেট প্যাকের অনুরোধ, ডাউনলোড পরিচালনা এবং অ্যাসেট অ্যাক্সেস করার জন্য C হেডার ফাইল play/asset_pack.h প্রদান করে।

Play Core Native SDK-এর জন্য আপনার ডেভেলপমেন্ট এনভায়রনমেন্ট সেট-আপ করুন

ডাউনলোড করুন Play Core Native SDK

ডাউনলোড করার আগে, আপনাকে অবশ্যই নিম্নলিখিত শর্তাবলীতে সম্মত হতে হবে।

শর্তাবলী

Last modified: September 24, 2020
  1. By using the Play Core Software Development Kit, you agree to these terms in addition to the Google APIs Terms of Service ("API ToS"). If these terms are ever in conflict, these terms will take precedence over the API ToS. Please read these terms and the API ToS carefully.
  2. For purposes of these terms, "APIs" means Google's APIs, other developer services, and associated software, including any Redistributable Code.
  3. “Redistributable Code” means Google-provided object code or header files that call the APIs.
  4. Subject to these terms and the terms of the API ToS, you may copy and distribute Redistributable Code solely for inclusion as part of your API Client. Google and its licensors own all right, title and interest, including any and all intellectual property and other proprietary rights, in and to Redistributable Code. You will not modify, translate, or create derivative works of Redistributable Code.
  5. Google may make changes to these terms at any time with notice and the opportunity to decline further use of the Play Core Software Development Kit. Google will post notice of modifications to the terms at https://developer.android.com/guide/playcore/license. Changes will not be retroactive.
ডাউনলোড করুন Play Core Native SDK

play-core-native-sdk-1.15.3.zip

  1. নিচের যেকোনো একটি করুন:

  2. সর্বশেষ CMake এবং Android নেটিভ ডেভেলপমেন্ট কিট (NDK) ইনস্টল করতে SDK ম্যানেজার ব্যবহার করে নেটিভ ডেভেলপমেন্টের জন্য Android স্টুডিও প্রস্তুত করুন। নেটিভ প্রোজেক্ট তৈরি বা আমদানি করার বিষয়ে আরও তথ্যের জন্য, NDK দিয়ে শুরু করা দেখুন।

  3. জিপ ফাইলটি ডাউনলোড করুন এবং আপনার প্রকল্পের পাশাপাশি এটি বের করুন।

    ডাউনলোড লিংক আকার SHA-256 চেকসাম
    37.8 MiB 9db60185185342f28d2c278b60222333608c67bc022e458a25224eaea8c4c4b7
  4. নীচে দেখানো হিসাবে আপনার অ্যাপের build.gradle ফাইল আপডেট করুন:

    গ্রোভি

        // App build.gradle
    
        plugins {
          id 'com.android.application'
        }
    
        // Define a path to the extracted Play Core SDK files.
        // If using a relative path, wrap it with file() since CMake requires absolute paths.
        def playcoreDir = file('../path/to/playcore-native-sdk')
    
        android {
            defaultConfig {
                ...
                externalNativeBuild {
                    cmake {
                        // Define the PLAYCORE_LOCATION directive.
                        arguments "-DANDROID_STL=c++_static",
                                  "-DPLAYCORE_LOCATION=$playcoreDir"
                    }
                }
                ndk {
                    // Skip deprecated ABIs. Only required when using NDK 16 or earlier.
                    abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64'
                }
            }
            buildTypes {
                release {
                    // Include Play Core Library proguard config files to strip unused code while retaining the Java symbols needed for JNI.
                    proguardFile '$playcoreDir/proguard/common.pgcfg'
                    proguardFile '$playcoreDir/proguard/gms_task.pgcfg'
                    proguardFile '$playcoreDir/proguard/per-feature-proguard-files'
                    ...
                }
                debug {
                    ...
                }
            }
            externalNativeBuild {
                cmake {
                    path 'src/main/CMakeLists.txt'
                }
            }
        }
    
        dependencies {
            // Import these feature-specific AARs for each Google Play Core library.
            implementation 'com.google.android.play:app-update:2.1.0'
            implementation 'com.google.android.play:asset-delivery:2.2.2'
            implementation 'com.google.android.play:integrity:1.4.0'
            implementation 'com.google.android.play:review:2.0.2'
    
            // Import these common dependencies.
            implementation 'com.google.android.gms:play-services-tasks:18.0.2'
            implementation files("$playcoreDir/playcore-native-metadata.jar")
            ...
        }
        

    কোটলিন

    // App build.gradle
    
    plugins {
        id("com.android.application")
    }
    
    // Define a path to the extracted Play Core SDK files.
    // If using a relative path, wrap it with file() since CMake requires absolute paths.
    val playcoreDir = file("../path/to/playcore-native-sdk")
    
    android {
        defaultConfig {
            ...
            externalNativeBuild {
                cmake {
                    // Define the PLAYCORE_LOCATION directive.
                    arguments += listOf("-DANDROID_STL=c++_static", "-DPLAYCORE_LOCATION=$playcoreDir")
                }
            }
            ndk {
                // Skip deprecated ABIs. Only required when using NDK 16 or earlier.
                abiFilters.clear()
                abiFilters += listOf("armeabi-v7a", "arm64-v8a", "x86", "x86_64")
            }
        }
        buildTypes {
            release {
                // Include Play Core Library proguard config files to strip unused code while retaining the Java symbols needed for JNI.
                proguardFile("$playcoreDir/proguard/common.pgcfg")
                proguardFile("$playcoreDir/proguard/gms_task.pgcfg")
                proguardFile("$playcoreDir/proguard/per-feature-proguard-files")
                ...
            }
            debug {
                ...
            }
        }
        externalNativeBuild {
            cmake {
                path = "src/main/CMakeLists.txt"
            }
        }
    }
    
    dependencies {
        // Import these feature-specific AARs for each Google Play Core library.
        implementation("com.google.android.play:app-update:2.1.0")
        implementation("com.google.android.play:asset-delivery:2.2.2")
        implementation("com.google.android.play:integrity:1.4.0")
        implementation("com.google.android.play:review:2.0.2")
    
        // Import these common dependencies.
        implementation("com.google.android.gms:play-services-tasks:18.0.2")
        implementation(files("$playcoreDir/playcore-native-metadata.jar"))
        ...
    }
  5. নীচে দেখানো হিসাবে আপনার অ্যাপের CMakeLists.txt ফাইলগুলি আপডেট করুন:

    cmake_minimum_required(VERSION 3.6)
    
    ...
    
    # Add a static library called “playcore” built with the c++_static STL.
    include(${PLAYCORE_LOCATION}/playcore.cmake)
    add_playcore_static_library()
    
    // In this example “main” is your native code library, i.e. libmain.so.
    add_library(main SHARED
            ...)
    
    target_include_directories(main PRIVATE
            ${PLAYCORE_LOCATION}/include
            ...)
    
    target_link_libraries(main
            android
            playcore
            ...)
    

তথ্য সংগ্রহ

Play Core Native SDK সংস্করণ সম্পর্কিত ডেটা সংগ্রহ করতে পারে যাতে Google-কে পণ্যের উন্নতি করতে দেয়, যার মধ্যে রয়েছে:

  • অ্যাপের প্যাকেজের নাম
  • অ্যাপের প্যাকেজ সংস্করণ
  • কোর নেটিভ SDK-এর সংস্করণ চালান

আপনি যখন প্লে কনসোলে আপনার অ্যাপ প্যাকেজ আপলোড করবেন তখন এই ডেটা সংগ্রহ করা হবে। এই ডেটা সংগ্রহ প্রক্রিয়া থেকে অপ্ট-আউট করতে, build.gradle ফাইলে $playcoreDir/playcore-native-metadata.jar ইম্পোর্ট সরিয়ে দিন।

দ্রষ্টব্য, আপনার প্লে কোর নেটিভ SDK ব্যবহার এবং Google-এর সংগৃহীত ডেটা ব্যবহারের সাথে সম্পর্কিত এই ডেটা সংগ্রহটি আপনি যখন Play কনসোলে আপনার অ্যাপ প্যাকেজ আপলোড করেন তখন Gradle-এ ঘোষিত লাইব্রেরি নির্ভরতাগুলির Google-এর সংগ্রহ থেকে আলাদা এবং স্বতন্ত্র।

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

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

#include <android/asset_manager.h>
#include <android_native_app_glue.h>
...
AAssetManager* assetManager = app->activity->assetManager;
AAsset* asset = AAssetManager_open(assetManager, "asset-name", AASSET_MODE_BUFFER);
size_t assetLength = AAsset_getLength(asset);
char* buffer = (char*) malloc(assetLength + 1);
AAsset_read(asset, buffer, assetLength);

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

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

অ্যাপ লঞ্চ

অন্য কোন ফাংশন কল করার আগে সর্বদা AssetPackManager_init() কল করুন অ্যাসেট প্যাক API আরম্ভ করার জন্য। কোনো সম্পদ প্যাক ত্রুটি কোড জন্য পরীক্ষা করুন.

#include "play/asset_pack.h"
...
AssetPackErrorCode AssetPackManager_init(JavaVM* jvm, jobject android_context);

এছাড়াও ANativeActivityCallbacks এর onPause() এবং onResume() এ নিম্নলিখিত ফাংশনগুলিকে কল করতে ভুলবেন না:

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

অ্যাসেট প্যাক আনার আগে অ্যাপগুলিকে ডাউনলোডের আকার প্রকাশ করতে হবে। AssetPackManager_requestInfo() ফাংশনটি ডাউনলোডের আকারের জন্য একটি অ্যাসিঙ্ক্রোনাস অনুরোধ শুরু করতে এবং প্যাকটি ইতিমধ্যে ডাউনলোড হচ্ছে কিনা তা ব্যবহার করুন৷ তারপরে ডাউনলোডের অবস্থার জন্য পোল করতে AssetPackManager_getDownloadState() ব্যবহার করুন (উদাহরণস্বরূপ, আপনার গেম লুপে প্রতি ফ্রেমে একবার এই ফাংশনটি কল করুন)। একটি অনুরোধ ব্যর্থ হলে, সম্পদ প্যাক ত্রুটি কোড চেক করুন।

AssetPackErrorCode AssetPackManager_requestInfo();      // Call once
AssetPackErrorCode AssetPackManager_getDownloadState(); // Call once per frame in your game loop

AssetPackManager_getDownloadState() ফাংশন একটি আউটপুট পয়েন্টার হিসাবে অস্বচ্ছ প্রকার AssetPackDownloadState প্রদান করে। নিম্নলিখিত ফাংশন কল করতে এই পয়েন্টার ব্যবহার করুন:

AssetPackDownloadState* state;
AssetPackErrorCode error_code = AssetPackManager_getDownloadState(asset-pack-name, &state);
AssetPackDownloadStatus status = AssetPackDownloadState_getStatus(state);
uint64_t downloadedBytes = AssetPackDownloadState_getBytesDownloaded(state);
uint64_t totalBytes = AssetPackDownloadState_getTotalBytesToDownload(state));
AssetPackDownloadState_destroy(state);

ইনস্টল করুন

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

AssetPackErrorCode AssetPackManager_requestDownload();  // Call once
AssetPackErrorCode AssetPackManager_getDownloadState(); // Call once per frame in your game loop

AssetPackManager_getDownloadState() ফাংশন অস্বচ্ছ প্রকার AssetPackDownloadState প্রদান করে। এই প্রকারটি কীভাবে ব্যবহার করবেন সে সম্পর্কে তথ্যের জন্য, ডাউনলোড তথ্য পান দেখুন।

বড় ডাউনলোড

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

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

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

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

ডাউনলোডের অনুরোধ COMPLETED অবস্থায় পৌঁছানোর পরে আপনি ফাইল সিস্টেম কল ব্যবহার করে একটি সম্পদ প্যাক অ্যাক্সেস করতে পারেন। প্রতিটি সম্পদ প্যাক অ্যাপের অভ্যন্তরীণ সঞ্চয়স্থানে একটি পৃথক ডিরেক্টরিতে সংরক্ষণ করা হয়। নির্দিষ্ট সম্পদ প্যাকের জন্য একটি AssetPackLocation পেতে AssetPackManager_getAssetPackLocation() ব্যবহার করুন। স্টোরেজ পদ্ধতি নির্ধারণ করতে সেই অবস্থানে AssetPackLocation_getStorageMethod() ব্যবহার করুন:

  • ASSET_PACK_STORAGE_APK : সম্পদ প্যাকটি একটি APK হিসাবে ইনস্টল করা হয়েছে৷ এই সম্পদগুলি অ্যাক্সেস করতে ইনস্টল-টাইম ডেলিভারি দেখুন।
  • ASSET_PACK_STORAGE_FILES : সম্পদ ধারণকারী ডিরেক্টরিতে একটি ফাইল পাথ পেতে AssetPackLocation_getAssetsPath() ব্যবহার করুন, অথবা যদি সম্পদগুলি ডাউনলোড না করা হয় তাহলে শূন্য। এই ফাইল পাথে ডাউনলোড করা ফাইল পরিবর্তন করবেন না।
AssetPackLocation* location;

AssetPackErrorCode error_code = AssetPackManager_getAssetPackLocation(asset-pack-name, &location);

if (error_code == ASSET_PACK_NO_ERROR) {
    AssetPackStorageMethod storage_method = AssetPackLocation_getStorageMethod(location);
    const char* assets_path = AssetPackLocation_getAssetsPath(location);
    AssetPackLocation_destroy(location);
}

একবার আপনি সম্পদগুলি সনাক্ত করার পরে, ফাইলগুলি অ্যাক্সেস করতে fopen বা ifstream এর মতো ফাংশনগুলি ব্যবহার করুন৷

অন্যান্য প্লে কোর API পদ্ধতি

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

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

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

অপসারণের অনুরোধ করুন

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

পরবর্তী পদক্ষেপ

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