讲师中心 微信公众号

工具推荐

视频效率加速
剧云
剧云

中文短剧剧本制作平台

Laper
Laper

剧本策划到成片协作

updream

一键生成高质量推广成片

AniShort
AniShort

AI短剧协同制作平台

Android应用内购:查询用户订阅状态的全面指南

老磊同学_4343

老磊同学_4343

发布时间:2025-11-28 18:12:24

|

546人浏览过

|

来源于php中文网

原创

Android应用内购:查询用户订阅状态的全面指南

本文详细介绍了如何在android应用中正确查询用户的订阅状态。我们将探讨querypurchasesasync()方法在应用启动时检查现有订阅的重要性,并区分其与实时购买更新监听器。教程将提供示例代码,指导如何处理和确认订阅,并强调了订阅管理的关键注意事项,旨在帮助开发者构建健壮的应用内购系统。

了解应用内购状态检查的必要性

在Android应用中集成订阅服务时,确保用户能够访问其已购买的特权至关重要。这不仅包括处理用户进行新购买时的回调,更重要的是,需要在应用启动或恢复时,主动查询并验证用户的现有订阅状态。仅依赖PurchasesUpdatedListener来更新订阅状态是不够的,因为它只在用户完成购买流程或发生其他购买事件时触发,而无法在应用首次启动或用户切换设备等场景下获取历史订阅信息。

为了可靠地检查用户的订阅状态,Google Play Billing Library 提供了专门用于查询现有购买记录的方法。

核心方法:查询现有订阅

要获取用户当前所有的有效购买(包括订阅和非消耗品),应使用 BillingClient 的 queryPurchasesAsync() 方法。此方法会返回一个购买列表,其中包含用户在当前设备上或通过其Google Play账户在任何设备上进行的、且尚未过期或撤销的购买。

以下是调用 queryPurchasesAsync() 并处理其结果的示例:

// 确保 BillingClient 已经连接
if (billingClient.isReady()) {
    billingClient.queryPurchasesAsync(
        QueryPurchasesParams.newBuilder().setProductType(BillingClient.ProductType.SUBS).build(),
        (billingResult, purchasesList) -> {
            if (billingResult.getResponseCode() == BillingClient.BillingResponseCode.OK) {
                if (purchasesList != null && !purchasesList.isEmpty()) {
                    for (Purchase purchase : purchasesList) {
                        // 处理每个有效的订阅
                        handleSubscriptionPurchase(purchase);
                    }
                    // 假设只要有一个有效订阅就认为用户已订阅
                    // 实际应用中可能需要更复杂的逻辑,例如检查特定SKU
                    Constant.subscription = true;
                } else {
                    // 没有找到有效订阅
                    Constant.subscription = false;
                }
            } else {
                // 查询失败,处理错误
                Log.e("BillingClient", "Query purchases failed: " + billingResult.getDebugMessage());
                Constant.subscription = false;
            }
        }
    );
} else {
    // BillingClient 未连接,尝试重新连接或等待连接成功
    Log.w("BillingClient", "BillingClient is not ready. Cannot query purchases.");
    Constant.subscription = false;
}

在上述代码中,我们指定 ProductType.SUBS 来专门查询订阅商品。对于一次性商品,可以使用 ProductType.INAPP。

Google Fonts
Google Fonts

在加载 Google Fonts 时注重性能、子集化及可靠的字体搭配。

下载

处理订阅购买与确认

当 queryPurchasesAsync() 返回一个购买列表,或者 PurchasesUpdatedListener 收到新的购买通知时,我们需要对这些购买进行处理。对于订阅和非消耗品,关键步骤是确认 (Acknowledge) 购买。Google Play 要求所有购买在三天内得到确认,否则将会被退款。

与消耗品(如游戏内货币)需要 consumeAsync() 不同,订阅和非消耗品不需要消耗。它们只需要被确认一次。

以下是针对订阅购买进行确认的 handleSubscriptionPurchase 方法示例:

void handleSubscriptionPurchase(Purchase purchase) {
    if (purchase.getPurchaseState() == Purchase.PurchaseState.PURCHASED) {
        // 检查购买是否已经确认
        if (!purchase.isAcknowledged()) {
            AcknowledgePurchaseParams acknowledgePurchaseParams =
                    AcknowledgePurchaseParams.newBuilder()
                            .setPurchaseToken(purchase.getPurchaseToken())
                            .build();

            billingClient.acknowledgePurchase(acknowledgePurchaseParams, billingResult -> {
                if (billingResult.getResponseCode() == BillingClient.BillingResponseCode.OK) {
                    // 订阅成功确认,更新UI或授予权限
                    Log.d("BillingClient", "Subscription acknowledged successfully: " + purchase.getSku());
                    Constant.subscription = true; // 示例:更新订阅状态
                    // 可以在此处调用服务器端验证逻辑
                } else {
                    Log.e("BillingClient", "Failed to acknowledge subscription: " + billingResult.getDebugMessage());
                }
            });
        } else {
            // 购买已确认,直接更新UI或授予权限
            Log.d("BillingClient", "Subscription already acknowledged: " + purchase.getSku());
            Constant.subscription = true; // 示例:更新订阅状态
        }
    } else if (purchase.getPurchaseState() == Purchase.PurchaseState.PENDING) {
        // 购买处于待处理状态,可能需要用户完成额外操作(如银行转账)
        Log.d("BillingClient", "Subscription is pending: " + purchase.getSku());
        Constant.subscription = false;
    }
    // 对于其他状态,如 Purchase.PurchaseState.UNSPECIFIED_STATE,可能需要进一步处理
}

集成到应用启动流程

为了在应用启动时检查订阅状态,通常建议在 MainActivity 或负责管理应用全局状态的组件的 onResume() 或 onCreate() 方法中调用 queryPurchasesAsync()。务必确保在调用此方法之前,BillingClient 已经成功连接到 Google Play 服务。

import androidx.annotation.NonNull;
import androidx.annotation.Nullable;
import androidx.appcompat.app.AppCompatActivity;

import android.os.Bundle;
import android.util.Log;

import com.android.billingclient.api.AcknowledgePurchaseParams;
import com.android.billingclient.api.BillingClient;
import com.android.billingclient.api.BillingClientStateListener;
import com.android.billingclient.api.BillingResult;
import com.android.billingclient.api.Purchase;
import com.android.billingclient.api.PurchasesUpdatedListener;
import com.android.billingclient.api.QueryPurchasesParams;

import java.util.List;

// 假设 Constant 类用于存储全局订阅状态
// class Constant { public static boolean subscription = false; }

public class MainActivity extends AppCompatActivity {

    private BillingClient billingClient;
    //

热门AI工具

更多
Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

更多
android开发三大框架
android开发三大框架

android开发三大框架是XUtil框架、volley框架、ImageLoader框架。本专题为大家提供android开发三大框架相关的各种文章、以及下载和课程。

942

2023.08.14

android是什么系统
android是什么系统

Android是一种功能强大、灵活可定制、应用丰富、多任务处理能力强、兼容性好、网络连接能力强的操作系统。本专题为大家提供android相关的文章、下载、课程内容,供大家免费下载体验。

2807

2023.08.22

android权限限制怎么解开
android权限限制怎么解开

android权限限制可以使用Root权限、第三方权限管理应用程序、ADB命令和Xposed框架解开。详细介绍:1、Root权限,通过获取Root权限,用户可以解锁所有权限,并对系统进行自定义和修改;2、第三方权限管理应用程序,用户可以轻松地控制和管理应用程序的权限;3、ADB命令,用户可以在设备上执行各种操作,包括解锁权限;4、Xposed框架,用户可以在不修改系统文件的情况下修改应用程序的行为和权限。

5697

2023.09.19

android重启应用的方法有哪些
android重启应用的方法有哪些

android重启应用有通过Intent、PendingIntent、系统服务、Runtime等方法。本专题为大家提供Android相关的文章、下载、课程内容,供大家免费下载体验。

745

2023.10.18

Android语音播放功能实现方法
Android语音播放功能实现方法

实现方法有使用MediaPlayer实现、使用SoundPool实现两种。可以根据具体的需求选择适合的方法进行实现。想了解更多语音播放的相关内容,可以阅读本专题下面的文章。

984

2024.03.01

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

0

2026.11.12

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

0

2026.11.12

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

0

2026.11.12

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

120

2026.11.06

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn