লাইসেন্সিং রেফারেন্স

LVL ক্লাস এবং ইন্টারফেস

সারণী 1 অ্যান্ড্রয়েড SDK-এর মাধ্যমে উপলব্ধ লাইসেন্স যাচাইকরণ লাইব্রেরির (LVL) সমস্ত উত্স ফাইলের তালিকা করে৷ সমস্ত ফাইল com.android.vending.licensing প্যাকেজের অংশ।

সারণি 1. LVL লাইব্রেরি ক্লাস এবং ইন্টারফেসের সারাংশ।

সার্ভার প্রতিক্রিয়া

সারণী 2 লাইসেন্সিং সার্ভার দ্বারা প্রত্যাবর্তিত সমস্ত লাইসেন্স প্রতিক্রিয়া ক্ষেত্রগুলির তালিকা করে৷

সারণি 2. Google Play সার্ভার দ্বারা প্রত্যাবর্তিত লাইসেন্স প্রতিক্রিয়া ক্ষেত্রগুলির সারাংশ৷

সার্ভার রেসপন্স কোড

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

সারণি 3. লাইসেন্স প্রতিক্রিয়ায় Google Play সার্ভার দ্বারা প্রত্যাবর্তিত প্রতিক্রিয়া কোডগুলির সারাংশ৷

দ্রষ্টব্য: টেস্টিং এনভায়রনমেন্ট সেট আপ- এ নথিভুক্ত হিসাবে, প্রতিক্রিয়া কোডটি অ্যাপ্লিকেশন ডেভেলপার এবং Google Play কনসোলের মাধ্যমে নিবন্ধিত পরীক্ষা ব্যবহারকারীদের জন্য ম্যানুয়ালি ওভাররাইড করা যেতে পারে।

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

সার্ভার প্রতিক্রিয়া অতিরিক্ত

অ্যাপ্লিকেশানের রিফান্ডের সময়কাল জুড়ে অ্যাপ্লিকেশানে অ্যাক্সেস পরিচালনা করতে এবং অন্যান্য তথ্য প্রদানে আপনার অ্যাপ্লিকেশনকে সহায়তা করতে, লাইসেন্সিং সার্ভারে লাইসেন্সের প্রতিক্রিয়াগুলিতে বেশ কয়েকটি তথ্য অন্তর্ভুক্ত থাকে। বিশেষত, পরিষেবাটি অ্যাপ্লিকেশনের লাইসেন্সের মেয়াদকাল, পুনরায় চেষ্টা করার গ্রেস পিরিয়ড, সর্বোচ্চ অনুমোদিত পুনরায় চেষ্টা গণনা এবং অন্যান্য সেটিংসের জন্য প্রস্তাবিত মান প্রদান করে। আপনার অ্যাপ্লিকেশান যদি APK সম্প্রসারণ ফাইলগুলি ব্যবহার করে, তাহলে প্রতিক্রিয়াতে ফাইলের নাম, আকার এবং URLগুলিও অন্তর্ভুক্ত থাকে৷ সার্ভার লাইসেন্স প্রতিক্রিয়া "অতিরিক্ত" ক্ষেত্রে কী-মানের জোড়া হিসাবে সেটিংস যুক্ত করে।

যেকোন Policy বাস্তবায়ন লাইসেন্সের প্রতিক্রিয়া থেকে অতিরিক্ত সেটিংস বের করতে পারে এবং প্রয়োজনে সেগুলি ব্যবহার করতে পারে। LVL ডিফল্ট Policy ইমপ্লিমেন্টেশন, ServerManagedPolicy , একটি কার্যকরী ইমপ্লিমেন্টেশন হিসেবে কাজ করে এবং কিভাবে সেটিংস প্রাপ্ত, সঞ্চয় এবং ব্যবহার করতে হয় তার একটি উদাহরণ হিসেবে কাজ করে।

সারণী 4. লাইসেন্স প্রতিক্রিয়ায় Google Play সার্ভার দ্বারা সরবরাহকৃত লাইসেন্স-ব্যবস্থাপনা সেটিংসের সারাংশ।

লাইসেন্সের মেয়াদকাল

Google Play লাইসেন্সিং সার্ভার সমস্ত ডাউনলোড করা অ্যাপ্লিকেশনের জন্য একটি লাইসেন্স বৈধতার সময়কাল সেট করে৷ সময়কালটি সময়ের ব্যবধানকে প্রকাশ করে যার উপর একটি অ্যাপ্লিকেশনের লাইসেন্সের স্থিতি অপরিবর্তিত এবং অ্যাপ্লিকেশনটিতে লাইসেন্সিং Policy দ্বারা ক্যাশেযোগ্য হিসাবে বিবেচনা করা উচিত। লাইসেন্সিং সার্ভারটি সমস্ত লাইসেন্স চেকের প্রতিক্রিয়াতে বৈধতার সময়কাল অন্তর্ভুক্ত করে, কী VT এর অধীনে অতিরিক্ত হিসাবে প্রতিক্রিয়াটিতে বৈধতার শেষের টাইমস্ট্যাম্প যুক্ত করে। একটি Policy VT কী মান বের করতে পারে এবং বৈধতার মেয়াদ শেষ না হওয়া পর্যন্ত লাইসেন্সটি পুনরায় পরীক্ষা না করে শর্তসাপেক্ষে অ্যাপ্লিকেশনটিতে অ্যাক্সেসের অনুমতি দিতে এটি ব্যবহার করতে পারে।

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

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

• একটি প্রদত্ত অ্যাপ্লিকেশনের জন্য, সার্ভার প্রাথমিক লাইসেন্সের বৈধতা সময়কাল সেট করে যাতে লাইসেন্সের প্রতিক্রিয়া যতক্ষণ পর্যন্ত আবেদনটি ফেরতযোগ্য হয় ততক্ষণ পর্যন্ত বৈধ থাকে। আবেদনে একটি লাইসেন্সিং Policy প্রাথমিক লাইসেন্স চেকের ফলাফল ক্যাশ করতে পারে এবং বৈধতার মেয়াদ শেষ না হওয়া পর্যন্ত লাইসেন্সটি পুনরায় পরীক্ষা করার প্রয়োজন নেই।
• যখন একটি অ্যাপ্লিকেশন আর ফেরতযোগ্য হয় না, সার্ভার একটি দীর্ঘ মেয়াদের সময়কাল সেট করে — সাধারণত অনেক দিন।
• একটি বিনামূল্যের অ্যাপ্লিকেশনের জন্য, সার্ভারটি একটি অত্যন্ত উচ্চ মান ( long.MAX_VALUE ) এর বৈধতার সময়কাল সেট করে৷ এটি নিশ্চিত করে যে, যদি Policy স্থানীয়ভাবে বৈধতার টাইমস্ট্যাম্প ক্যাশ করে থাকে, তাহলে ভবিষ্যতে আবেদনের লাইসেন্সের স্থিতি পুনরায় পরীক্ষা করার প্রয়োজন হবে না।

ServerManagedPolicy পলিসি বাস্তবায়ন ব্যবহারকারীকে অ্যাপ্লিকেশান অ্যাক্সেস করার অনুমতি দেওয়ার আগে সার্ভারের সাথে লাইসেন্সের স্থিতি পুনঃচেক করতে হবে কিনা তা নির্ধারণের প্রাথমিক শর্ত হিসাবে নিষ্কাশিত টাইমস্ট্যাম্প ( mValidityTimestamp ) ব্যবহার করে৷

পুনরায় চেষ্টা করার সময়কাল এবং সর্বোচ্চ পুনঃপ্রচেষ্টা গণনা

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

যখন নেটওয়ার্ক সমস্যাগুলি লাইসেন্স পরীক্ষাকে বাধা দেয় বা বাধা দেয়, তখন Google Play ক্লায়েন্ট Policy processServerResponse() পদ্ধতিতে একটি RETRY প্রতিক্রিয়া কোড ফেরত দিয়ে অ্যাপ্লিকেশনটিকে অবহিত করে৷ সিস্টেম সমস্যার ক্ষেত্রে, যেমন অ্যাপ্লিকেশনটি যখন Google Play এর ILicensingService বাস্তবায়নের সাথে আবদ্ধ হতে অক্ষম হয়, তখন LicenseChecker লাইব্রেরি নিজেই একটি RETRY প্রতিক্রিয়া কোড সহ Policy processServerResponse() পদ্ধতিকে কল করে।

সাধারণভাবে, RETRY রেসপন্স কোড হল অ্যাপ্লিকেশনটির জন্য একটি সংকেত যে একটি ত্রুটি ঘটেছে যা লাইসেন্স চেক সম্পূর্ণ হতে বাধা দিয়েছে।

Google Play সার্ভার একটি অ্যাপ্লিকেশনকে ত্রুটির শর্তে লাইসেন্সিং পরিচালনা করতে একটি পুনঃচেষ্টা "অনুগ্রহের সময়কাল" সেট করে এবং একটি প্রস্তাবিত সর্বোচ্চ পুনঃপ্রচার গণনা সেট করে সহায়তা করে৷ সার্ভার সমস্ত লাইসেন্স চেক প্রতিক্রিয়াগুলিতে এই মানগুলিকে অন্তর্ভুক্ত করে, GT এবং GR কীগুলির অধীনে অতিরিক্ত হিসাবে যুক্ত করে।

অ্যাপ্লিকেশন Policy GT এবং GR অতিরিক্তগুলি বের করতে পারে এবং শর্তসাপেক্ষে অ্যাপ্লিকেশনটিতে অ্যাক্সেসের অনুমতি দেওয়ার জন্য ব্যবহার করতে পারে, নিম্নরূপ:

• একটি লাইসেন্স চেক করার জন্য যার ফলস্বরূপ RETRY প্রতিক্রিয়া দেখা যায়, Policy RETRY প্রতিক্রিয়া কোডটি ক্যাশে করা উচিত এবং RETRY প্রতিক্রিয়াগুলির সংখ্যা বৃদ্ধি করা উচিত।
• Policy ব্যবহারকারীকে অ্যাপ্লিকেশানটি অ্যাক্সেস করার অনুমতি দেওয়া উচিত, যদি হয় পুনঃপ্রচেষ্টার গ্রেস পিরিয়ড এখনও সক্রিয় থাকে বা সর্বোচ্চ পুনঃপ্রচারের গণনা পৌঁছানো না হয়।

ServerManagedPolicy উপরে বর্ণিত হিসাবে সার্ভার দ্বারা সরবরাহকৃত GT এবং GR মান ব্যবহার করে। নীচের উদাহরণটি allow() পদ্ধতিতে পুনরায় চেষ্টা করার প্রতিক্রিয়াগুলির শর্তসাপেক্ষ পরিচালনা দেখায়। RETRY প্রতিক্রিয়ার গণনা processServerResponse() পদ্ধতিতে বজায় রাখা হয়, দেখানো হয় না।

fun allowAccess(): Boolean {
    val ts = System.currentTimeMillis()
    return when(lastResponse) {
        LICENSED -> {
            // Check if the LICENSED response occurred within the validity timeout.
            ts <= validityTimestamp  // Cached LICENSED response is still valid.
        }
        RETRY -> {
            ts < lastResponseTime + MILLIS_PER_MINUTE &&
                    // Only allow access if we are within the retry period
                    // or we haven't used up our max retries.
                    (ts <= retryUntil || retryCount <= maxRetries)
        }
        else -> false
    }
}

public boolean allowAccess() {
    long ts = System.currentTimeMillis();
    if (lastResponse == LicenseResponse.LICENSED) {
        // Check if the LICENSED response occurred within the validity timeout.
        if (ts <= validityTimestamp) {
            // Cached LICENSED response is still valid.
            return true;
        }
    } else if (lastResponse == LicenseResponse.RETRY &&
                ts < lastResponseTime + MILLIS_PER_MINUTE) {
        // Only allow access if we are within the retry period
        // or we haven't used up our max retries.
        return (ts <= retryUntil || retryCount <= maxRetries);
    }
    return false;
}