ข้อมูลอ้างอิงการให้สัญญาอนุญาต

คลาสและอินเทอร์เฟซ LVL

ตาราง 1 แสดงไฟล์ต้นทางทั้งหมดในการยืนยันใบอนุญาต ไลบรารี (LVL) ที่พร้อมใช้งานผ่าน Android SDK ไฟล์ทั้งหมดเป็นส่วนหนึ่งของ แพ็กเกจ com.android.vending.licensing

ตาราง 1 สรุปไลบรารี LVL คลาสและอินเทอร์เฟซได้

การตอบกลับของเซิร์ฟเวอร์

ตารางที่ 2 จะแสดงช่องการตอบกลับเกี่ยวกับใบอนุญาตทั้งหมดที่แสดงผลโดย เซิร์ฟเวอร์การให้สัญญาอนุญาต

ตาราง 2 ข้อมูลสรุปของช่องตอบกลับเกี่ยวกับใบอนุญาต แสดงโดยเซิร์ฟเวอร์ Google Play

โค้ดตอบกลับของเซิร์ฟเวอร์

ตารางที่ 3 แสดงรายการโค้ดตอบกลับของใบอนุญาตทั้งหมดที่ เซิร์ฟเวอร์การให้สัญญาอนุญาต โดยทั่วไป แอปพลิเคชันควรจัดการการตอบสนองทั้งหมดนี้ โดยค่าเริ่มต้น คลาส LicenseValidator ใน LVL จะแสดง การจัดการโค้ดตอบกลับเหล่านี้ที่จำเป็นให้กับคุณ

ตารางที่ 3 สรุปโค้ดตอบกลับ แสดงโดยเซิร์ฟเวอร์ Google Play ในการตอบกลับเกี่ยวกับใบอนุญาต

หมายเหตุ: ตามที่ได้ระบุไว้ในเอกสาร การตั้งค่าสภาพแวดล้อมการทดสอบ คุณสามารถโค้ดตอบกลับด้วยตนเองได้ สำหรับนักพัฒนาแอปพลิเคชันและผู้ใช้ทดสอบที่ลงทะเบียนไว้ผ่าน Google Play Console

หมายเหตุ: ก่อนหน้านี้คุณทดสอบแอปได้โดย อัปโหลด "ฉบับร่าง" ที่ยังไม่ได้เผยแพร่ เวอร์ชัน ฟังก์ชันนี้ใช้งานไม่ได้อีกต่อไป สนับสนุน คุณต้องเผยแพร่ไปยังการเผยแพร่อัลฟาหรือเบต้าแทน สำหรับข้อมูลเพิ่มเติม โปรดดูที่แอปฉบับร่าง ไม่ได้รองรับอีกต่อไป

ข้อมูลเพิ่มเติมเกี่ยวกับการตอบกลับของเซิร์ฟเวอร์

เพื่อช่วยแอปพลิเคชันของคุณในการจัดการการเข้าถึงแอปพลิเคชันในการคืนเงินในแอปพลิเคชัน และให้ข้อมูลอื่น เซิร์ฟเวอร์การให้สัญญาอนุญาตจะประกอบด้วย ในการตอบกลับเกี่ยวกับใบอนุญาต กล่าวโดยเจาะจงคือ บริการจะให้ค่าที่แนะนำสำหรับ ระยะเวลาความถูกต้องของใบอนุญาตของแอปพลิเคชัน ระยะเวลาผ่อนผันสำหรับการลองใหม่ จำนวนการลองใหม่สูงสุดที่อนุญาต และอื่นๆ การตั้งค่า หากแอปพลิเคชันของคุณใช้ APK ไฟล์เสริม การตอบกลับจะมีชื่อไฟล์ ขนาด และ URL ด้วย เซิร์ฟเวอร์เพิ่ม การตั้งค่าเป็นคู่คีย์-ค่าในการตอบกลับใบอนุญาต "extras" ด้วย

การใช้งาน Policy จะดึงการตั้งค่าเพิ่มเติมจากใบอนุญาตได้ ตอบสนองและนำไปใช้ตามความจำเป็น การใช้งาน Policy เริ่มต้น LVL คือ 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 จะแจ้งเตือนแอปพลิเคชันโดยแสดงโค้ดตอบกลับ RETRY ไปยัง เมธอด processServerResponse() ของ Policy ในกรณีที่เป็นระบบ เช่น เมื่อแอปพลิเคชันไม่สามารถเชื่อมโยงกับ ILicensingService ไลบรารี LicenseChecker เรียกฟิลด์ เมธอด processServerResponse() ของนโยบายที่มีโค้ดตอบกลับ RETRY

โดยทั่วไป โค้ดตอบกลับ 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;
}