跳到主要内容
Didit 融资 750 万美元,打造身份与欺诈基础设施
Didit
返回博客
博客 · 2026年11月22日

Play Age Signals API 集成指南:适用于 Android 应用的 v0.0.6

使用 Kotlin 实现 Play Age Signals 0.0.6 的三次调用,涵盖针对每个 status、tier 和 bound 的决策表、错误处理、从 0.0.3 和 0.0.4 迁移、测试以及如何启动您自己的年龄核验。

作者:Didit更新于
play-age-signals-api-integration-cover.png

简而言之

如今要集成 Play Age Signals API,请添加 com.google.android.play:age-signals:0.0.6,通过 Activity 调用 requestAgeSignalsAccess,并且仅在状态为 SHARED 时调用 checkAgeSignals。[1][2]

  • 从 ageLower 读取年龄。层级说明该年龄的确认方式,null 绝不代表成年人。
  • 尽管指南中注明为 API 23,但 0.0.6 库清单声明的 minSdk 为 24。[1][11]
  • 该信号保留在您的应用内。如果您需要进行自己的年龄核验,请在没有该信号的情况下启动核验。

最近审核:2026 年 11 月 22 日 · 非法律建议

这是 Play Age Signals API 的工程指南:先介绍 Android,然后是 Flutter、React Native、Expo 和 Unity。关于受影响的对象以及 2027 年 1 月生效的内容,请阅读Google Play Age Signals API:2027 年 1 月有哪些变化。Google 提供该 API,并不强制您调用;但法律可能会强制要求。

以下所有类、方法和枚举均于 2026 年 11 月 22 日对照 Google 页面和已发布的 0.0.6 库进行了核对;该信号相关的 Kotlin 代码也能基于该库编译通过。

所需条件

该 API 通过设备上的 Play Store 应用在手机、折叠屏设备和平板电脑上运行。[1][5]

  • 将 minSdk 设置为 24(参见警告)。
  • 通过 Google Play 分发:条款将该 API 限制为由 Google Play 更新的应用。[5]
  • 在 Play Console 中打开 Age signals 页面:自定义年龄、重大变更以及已撤销的批准均在该处处理。[3][8][9]
  • 自行填写 Play 的数据安全表单。Google 表示客户端库不收集任何数据,表单内容由您自行决定。[5]

注意事项

Google 的配置页面注明为 Android 6.0、API 级别 23。[1]0.0.6 库内部的清单声明了 minSdkVersion 24;0.0.3 和 0.0.4 声明的是 23。[11]升级后,minSdk 23 的应用可能会在清单合并时构建失败。提升至 24 是简单的解决方法。

  1. 2026 年 2 月0.0.3一次调用,userStatus 新增 DECLARED。
  2. 2026 年 7 月0.0.4两次调用,层级取代 userStatus。
  3. 2026 年 11 月0.0.6全球可用,新增 getApplicableAgeFeatures。
  4. 2026 年 12 月 11 日所有用户Google 面向所有人返回响应的日期。

库版本,源自 Google 的版本说明和横幅。[2][4]在该日期之前,预计部分用户不会获得响应。

添加库

单个依赖项。[1]用于测试的模拟管理器位于同一构件中。[11]

dependencies {
    implementation("com.google.android.play:age-signals:0.0.6")
}

1getApplicableAgeFeatures(可选)

该用户是否必须共享。

2requestAgeSignalsAccess

可能会显示 Google Play 自身的提示。

状态为 SHARED

是

3checkAgeSignals

读取界限、来源和变更状态。

否

Google 未提供年龄

使用适合年龄的默认设置。

0.0.6 中的调用顺序。[2]

步骤 1:该用户是否必须共享

该调用为可选项。[2] 仅当用户所在地区的法律要求应用商店共享年龄信息时,features() 才会包含 MANDATORY_SHARING,对其他所有用户则为空。[2]

val manager = AgeSignalsManagerFactory.create(applicationContext)

manager.getApplicableAgeFeatures(ApplicableAgeFeaturesRequest.builder().build())
    .addOnSuccessListener { result ->
        val mandatory = ApplicableAgeFeature.MANDATORY_SHARING in result.features()
        // Use it to word your own screen. It is not an age.
    }
    .addOnFailureListener { error -> handleAgeSignalsError(error) }

注意

强制表示用户必须共享。它未说明年龄是如何确定的:Google 的文档说明 MANDATORY_SHARING 可与 TIER_A、TIER_B、TIER_C 和 TIER_D 同时出现。[3]

步骤 2:请求访问权限

Google 文档中写为 requestAgeSignalsAccess(Activity);该方法接受携带 Activity 的 AgeSignalsAccessRequest。[2] 请在适合显示提示的位置调用它。

val request = AgeSignalsAccessRequest.builder()
    .setActivity(this)
    .build()

manager.requestAgeSignalsAccess(request)
    .addOnSuccessListener { access ->
        when (access.ageSignalsStatus()) {
            AgeSignalsStatus.SHARED -> readSignals(manager)
            AgeSignalsStatus.NOT_SHARED -> applyGate(AgeGate.NoSignal)
            AgeSignalsStatus.VERIFICATION_REQUIRED -> applyGate(AgeGate.VerifyInPlay)
            else -> applyGate(AgeGate.NoSignal) // UNSPECIFIED or null
        }
    }
    .addOnFailureListener { error -> handleAgeSignalsError(error) }

用户看到的内容取决于地区和设置:[2]

用户提示状态
要求商店提供已验证年龄的美国州;已验证或受监护无SHARED
同上,尚未核实应用内无提示;由 Play 处理VERIFICATION_REQUIRED
其他地区,共享前询问(默认设置[14])Play 的应用内提示SHARED 或 NOT_SHARED
其他地区,始终共享无SHARED
其他地区,从不共享无NOT_SHARED
其他地区,受监护无;由家长在 Family Link 中决定SHARED 或 NOT_SHARED

用户关闭数次后,Play 会停止显示提示,因此请勿循环调用。[2] 在强制要求共享的情况下,该设置固定为“始终共享”。[14]

将您的年龄门禁映射到该信号

向我们展示您的门禁设置和目标市场,我们将向您说明哪些分支需要您自行核验,哪些不需要。

预约演示免费开始

步骤 3:读取结果

每个字段均可为空,因此只需转换一次并在应用中保持统一类型。此映射仅从界限读取年龄。

sealed interface AgeGate {
    data object NoSignal : AgeGate
    data object VerifyInPlay : AgeGate
    data class Range(
        val lower: Int,
        val upper: Int?,         // null = top band, not "adult"
        val source: Int?,        // AgeRangeSource.TIER_A to TIER_D
        val changeStatus: Int?   // SignificantChangeStatus
    ) : AgeGate {
        fun isAtLeast(age: Int) = lower >= age
    }
}

fun toAgeGate(r: AgeSignalsResult): AgeGate {
    val lower: Int = r.ageLower() ?: return AgeGate.NoSignal
    return AgeGate.Range(
        lower, r.ageUpper(), r.ageRangeSource(), r.significantChangeStatus()
    )
}

private fun readSignals(manager: AgeSignalsManager) {
    manager.checkAgeSignals(AgeSignalsRequest.builder().build())
        .addOnSuccessListener { result -> applyGate(toAgeGate(result)) }
        .addOnFailureListener { error -> handleAgeSignalsError(error) }
}

状态、来源和变更常量均为整数,其中 0 为 UNSPECIFIED。[10][11] 请在 else 分支中处理该情况。Google 的 0.0.3 版指南建议在应用打开时发起全新请求,因为这些值可能会发生变化[12];用户随后也可以关闭共享。[14]

注意

该指南还建议同时调用 Play Integrity API,以确保调用来自经过认证的设备上未被篡改的构建版本。[12] 该信号是客户端响应:切勿信任被修改的客户端向您的服务器提交的年龄区间。

决策表:状态 x 来源 x 界限

默认区间为 0-12、13-15、16-17 和 18+。[3] 最后一列是我们的工程建议,并非 Google 的建议。

状态来源下限 / 上限含义您的代码应执行的操作
异常无无无响应[7]若可重试则重试,否则视为无信号
NOT_SHAREDnullnull / null用户或家长未同意共享[2][3]采用适合年龄的默认设置,不重复提示
VERIFICATION_REQUIREDnullnull / null未核验,且位于强制要求核验与共享的地区[2][3]引导至 Play Store,保留默认设置
SHAREDTIER_A13 / 15用户向 Google 提供了年龄,Google 可能已确认也可能未确认[3]应用该年龄段
SHAREDTIER_A18 / null同上,成年人年龄段[3]直接应用;仅在法律或风险有更高要求时追加核验
SHAREDTIER_B13 / 15年龄由父母或监护人管理[3]应用该年龄段,读取变更状态
SHAREDTIER_C18 / null通过信用卡、电子邮件、自拍、政府身份证件或税号进行评估[3]应用该年龄段
SHAREDTIER_D18 / null政府身份证件加自拍,或数字身份证件[3]应用该年龄段
SHARED任意null / 任意不在 Google 的响应表中视为无信号

三种解读最容易引发错误:

  • TIER_A 并不等于“未验证”。通过数字身份完成验证但选择自主共享的成年人,其结果也会显示为 TIER_A。[3]TIER_C 和 TIER_D 仅在强制要求年龄验证的地区返回,例如德克萨斯州。[3]类参考文档将 TIER_A 标记为“自我声明”;响应指南对此表述更为严谨。[3][10]
  • TIER_B 不是年龄。它仅说明由谁管理。请读取具体区间界限。
  • Null 界限不代表已验证的成年人。Google 的 Java 示例注释暗示了这一点;其 Kotlin 示例则表明用户未共享,响应表与 Kotlin 示例一致。[2][3]

何时在此停止

如果该年龄段已能回答您的问题,且没有任何法律或风险要求更多信息,即可停止。对每位用户进行二次检查很难符合数据最小化原则,而在加利福尼亚州,除非您掌握内部明确且令人信服的信息,否则该信号即为主要指标。[15]

若某个分支的结果为无信号,后续处理流程的设计请参阅遇到 NOT_SHARED、TIER_A 或无应答时的应对方案。

在信号缺失时获取明确结果

在您的应用中预约年龄估计演示:先自拍,仅对临界情况核验身份证件。

预约演示免费开始

自定义最低年龄

在自定义年龄范围选项卡中,您最多可以输入三个最低年龄,彼此间隔至少两年,每年可更改一次。它们会覆盖默认响应。[3]

设置的最低年龄返回的范围最高区间
无(默认)0-12, 13-15, 16-17, 18+18 / null
150-14, 15+15 / null
13, 170-12, 13-16, 17+17 / null
11, 13, 150-10, 11-12, 13-14, 15+15 / null

来自 Google 响应指南的示例。[3]

示例

假设您设置了 13 和 17。25 岁用户现在会返回 17 / null,与 17 岁用户相同。如果代码将值为 null 的 ageUpper 解读为成年人,就会让 17 岁用户进入 18+ 功能。因此,如果您以 18 岁设限,请在列表中保留 18。文档记录的界限止于 18[3]:此 API 无法用于 21 岁门槛。

重大变更与已撤销的批准

这两项功能均适用于受监护用户。某项变更是否构成重大变更、依据哪项法律,由您判断,而不是由 Play 判断[8];各州的规定详见 App Store Accountability Acts。

您通知 Play

重大变更

  • 最多 3 次变更,最多提前 90 天,相隔超过 2 天
  • 需要英文描述,原样展示给家长
  • significantChangeStatus 为 APPROVED、PENDING 或 DECLINED
  • 您的应用必须限制已变更的功能

累积生效:一次批准涵盖所有待处理的变更[8]

Play 会通知您

已撤销的批准

  • installId 按用户和设备区分,重置后无法保留
  • 您仅可出于此目的将其存储在后端
  • 已撤销的 ID 会以 CSV 文件形式出现在 Play Console 中
  • 每条记录会在 90 天后删除,因此请定期下载

同一个 ID 可能会出现多次[9]

在 PENDING 和 DECLINED 状态下限制已变更的功能,而非整个应用。对于非受监护账户以及无记录变更的受监护账户,此状态为 null。[3]

错误和不受支持的设备

故障会以 AgeSignalsException 形式返回。Google 建议设置最大尝试次数进行重试。[7]

// -8 (CLIENT_TRANSIENT_ERROR) to -1 (API_NOT_AVAILABLE) are marked retryable
private val RETRYABLE =
    AgeSignalsErrorCode.CLIENT_TRANSIENT_ERROR..AgeSignalsErrorCode.API_NOT_AVAILABLE
private var attempts = 0

fun handleAgeSignalsError(e: Exception) {
    val code = (e as? AgeSignalsException)?.errorCode
    if (code in RETRYABLE && attempts++ < 3) retryLater()
    else applyGate(AgeGate.NoSignal)
}
代码常量重试操作
-1, -6API_NOT_AVAILABLE, PLAY_STORE_VERSION_OUTDATED是提示更新 Play Store
-2PLAY_STORE_NOT_FOUND是提示安装或启用 Play Store
-3NETWORK_ERROR是提示检查网络连接
-4, -7PLAY_SERVICES_NOT_FOUND, PLAY_SERVICES_VERSION_OUTDATED是提示安装、启用或更新 Play Services
-5CANNOT_BIND_TO_SERVICE是指数退避,然后更新 Play Store
-8CLIENT_TRANSIENT_ERROR是限制重试次数,然后稍后再试
-9APP_NOT_OWNED否非通过 Google Play 安装:侧载或其他商店
-10SDK_VERSION_OUTDATED否发布更新版本的库
-11DEVICE_NOT_SUPPORTED否设备类型不支持;0.0.6 中新增[4]
-100INTERNAL_ERROR否Google 的文档仍建议限制重试次数;上述代码不会重试

Google 错误代码参考。[7] 错误并非年龄:请回退至默认体验。

从 0.0.3 和 0.0.4 迁移

版本 0.0.3 仍会返回响应,但不再获得更新。[12] 从该版本迁移需要重写读取路径;从 0.0.4 迁移改动较小。

在您的代码中在 0.0.6 中从
仅 checkAgeSignals先调用 requestAgeSignalsAccess[4]0.0.3
userStatus()已移除:ageRangeSource() 和 significantChangeStatus()[4]0.0.3
VERIFIEDTIER_C 或 TIER_D(我们的解读)0.0.3
DECLAREDTIER_A,如果由家长管理则为 TIER_B(我们的解读)0.0.3
SUPERVISEDTIER_B(我们的解读)0.0.3
SUPERVISED_APPROVAL_PENDING、SUPERVISED_APPROVAL_DENIED带 PENDING 或 DECLINED 的 TIER_B(我们的解读)0.0.3
UNKNOWN、null访问状态:VERIFICATION_REQUIRED 或 NOT_SHARED(我们的解读)0.0.3
mostRecentApprovalDate()significantChangeApprovalDate()[4]0.0.3
两次调用、层级未变更;如果有用,可添加 getApplicableAgeFeatures[4]0.0.4
错误处理添加 DEVICE_NOT_SUPPORTED[4]两者
minSdk 23库声明为 24[11]两者

Google 未发布逐个值的映射表。标有“我们的解读”的行来自两组定义的对比。[3][12]

注意事项

旧的 AgeSignalsVerificationStatus 常量仍包含在 0.0.6 中,因此导入能通过编译,但 userStatus() 并不存在。[11]在 0.0.3 中,VERIFIED 为 0;在 0.0.6 中,0 为 UNSPECIFIED。[10][11]升级时请清除缓存的整数值。

使用 FakeAgeSignalsManager 和许可测试人员进行测试

FakeAgeSignalsManager 从不与 Play Store 通信;其参考文档将其限制在单元测试和早期开发中。[32]注入该管理器,以便随时替换它。

val fake = FakeAgeSignalsManager()

// Sharing is mandatory for this user
fake.setNextApplicableAgeFeaturesResult(
    ApplicableAgeFeaturesResult.builder()
        .setFeatures(setOf(ApplicableAgeFeature.MANDATORY_SHARING))
        .build()
)
// Verification still pending in Play
fake.setNextAgeSignalsAccessResult(
    AgeSignalsAccessResult.builder()
        .setAgeSignalsStatus(AgeSignalsStatus.VERIFICATION_REQUIRED)
        .build()
)
// Supervised 13 to 15, change waiting for the parent
fake.setNextAgeSignalsResult(
    AgeSignalsResult.builder()
        .setAgeRangeSource(AgeRangeSource.TIER_B)
        .setAgeLower(13)
        .setAgeUpper(15)
        .setSignificantChangeStatus(SignificantChangeStatus.PENDING)
        .setInstallId("fake_install_id_123")
        .build()
)
// Fails checkAgeSignals
fake.setNextAgeSignalsException(
    AgeSignalsException(AgeSignalsErrorCode.NETWORK_ERROR)
)
  • 覆盖每种状态、未成年人年龄区间、成年人年龄区间、null 界限以及每次调用各一次错误(setNextRequestAgeSignalsAccessException 和 setNextApplicableAgeFeaturesException 会导致另外两次调用失败)。
  • 通过许可测试人员运行实时调用:通常未由 Play 更新的应用会收到 APP_NOT_OWNED;测试人员可以侧载调试版本。[6]
  • 保持包名与 Play 应用一致,并使用测试人员账号登录。[6]

Flutter、React Native、Expo 和 Unity

这些是社区或框架提供的软件包,非 Google 官方提供,列出并不代表推荐。发布前请检查库版本。

技术栈已检查软件包库发版前须知
Expoexpo-age-range 58.0.30.0.4在 Web 端以及 iOS 26 之前的版本上,它返回 lowerBound: 18,就如同成年人一样[17]
React Nativereact-native-play-age-range-declaration 3.0.50.0.4同时封装了其他商店和 Apple[19]
Flutterage_range_signals 0.10.10.0.4两次调用的流程,支持许可测试人员[18]
Unityunity-play-age-signals0.0.4GPL-3.0;回调可能会在主线程之外运行[20]

于 2026 年 11 月 22 日从各软件包页面或构建文件中读取。[17][18][19][20] Unity 员工在 2025 年 12 月发帖称 Unity 不会发布专门的插件。[21]

仍基于 0.0.4 的软件包没有 getApplicableAgeFeatures,也没有 DEVICE_NOT_SUPPORTED。如果您需要它们,请编写一个小型的原生桥接层。Apple 侧的对比见 Play Age Signals 与 Apple Declared Age Range 对比。

请勿记录日志、共享或进行画像分析

Google 的条款将这些信息的使用限制在发出请求的应用内、用于符合法律规定的适龄体验。[5] 该政策禁止广告、分析、用户画像,并禁止向任何第三方出售、共享或传输数据,除非法律有严格要求。[13]

  • 避免将年龄区间、层级和 installId 写入日志、崩溃报告和分析事件中:这些工具通常属于第三方。
  • 尽可能将原始结果保存在内存中,并存储功能决策而非层级。
  • 切勿将该信号与任何年龄核验供应商关联,包括 Didit。
  • 在加利福尼亚州,不要提示用户更改其年龄信息,也不要出于该法案未要求的目的向第三方共享任何信号。[15]
  • 在为每位用户请求年龄信号之前请先咨询法律顾问:加利福尼亚州的法律禁止提出既非该法也非其他适用法律所要求的请求。[15]

因此,“访问 Play Store”的提示应当对应 VERIFICATION_REQUIRED,而不是发给对其年龄段存疑的加利福尼亚州用户。Google 的区域页面列出加利福尼亚州和巴西自 2027 年 1 月起为强制要求,阿拉巴马州则标为“详情即将公布”。[16] 加利福尼亚州的义务详见 Digital Age Assurance Act 指南。

获取信号之后:启动您自己的核验

由您的应用决定是否需要核验;请求携带工作流和您的用户 ID,绝不能包含 Google 的应答。请从您的服务器调用 Didit,因为 API 密钥绝不能到达设备端。

curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "YOUR_AGE_WORKFLOW_ID",
    "vendor_data": "user-42"
  }'

201 响应包含 session_id、session_token 和 url。[25] 仅将令牌发送到应用,然后启动 SDK:[26]

// Once, in Application.onCreate: DiditSdk.initialize(this)

lifecycleScope.launch {
    DiditSdk.state.collect { state ->
        if (state is DiditSdkState.Ready) DiditSdk.launchVerificationUI(this@MainActivity)
    }
}

DiditSdk.startVerification(token = sessionToken) { result ->
    when (result) {
        is VerificationResult.Completed -> refreshAgeDecision() // asks your server
        is VerificationResult.Cancelled -> keepSafeDefault()
        is VerificationResult.Failed -> keepSafeDefault()
    }
}

SDK 的结果仅供界面使用。请从带签名的 status.updated Webhook 回调获取决策,或由您的服务器读取 GET /v3/session/{sessionId}/decision/。[25][29] 取消和失败时请保持安全的默认设置。

了解限制

在信号已足够的情况下,可跳过此步骤。自行核验并不总是更优。具有 2027 年生效义务的阿拉巴马州和犹他州法案对其所涵盖的保护措施采用最低年龄类别,而巴西则采用保护性更强的替代方案,因此在这些地方,核验只会使限制更严格。[22][23][24] 受伊利诺伊州、德克萨斯州或科罗拉多州法律管辖的人群在自拍前需要生物识别同意步骤,原生 SDK 4.10.0 或更高版本可以显示该步骤。[28] 请与法律顾问确认哪项规则适用于您的应用。

Didit 如何在收到信号后提供帮助

Didit Age Estimation 通过自拍估算年龄,在同一步骤中完成活体检测,且不识别该人的具体身份。工作流可将您设定的临界区间转入证件核验。[27] Age Estimation 每次调用费用为 $0.10;请参阅价格。

Didit console, age estimation result of a verification: the estimated age from the selfie next to the age on the document

Didit 控制台中的年龄估算结果(示例数据):自拍估算的年龄显示在证件年龄旁边。

提供适用于 Android、iOS、React Native 和 Flutter 的原生 SDK。对于 Unity 和其他引擎,文档推荐的途径是 WebView 集成。[31] Google Play 以外的场景在年龄核验 API:应用、网页与应用商店以及年龄核验解决方案页面中均有说明。

Didit 提供

  • 包含自拍、活体检测和可选证件步骤的托管式年龄核验
  • 符合 ISO/IEC 27566-1 的工作流选项,仅返回关于年龄的是或否判定,不返回个人数据,支持最低 13 岁的年龄门槛[27]
  • 保留周期、返回数据开关以及删除调用[30]

留在您端

  • Play Age Signals 调用及其结果
  • 适用哪项法律以及是否需要进行核验
  • 适龄默认设置与最终访问决策

Didit 没有 Play Age Signals 连接器:信号保留在您的应用中。

查看在您的应用中运行的兜底分支

带上您的年龄门禁、目标市场和技术栈,或自行构建工作流。

预约演示免费开始阅读文档

核心要点

  • 使用 0.0.6:可选功能调用、访问请求,然后仅在 SHARED 时调用 checkAgeSignals。
  • 基于 ageLower 设置年龄门禁;ageUpper 为 null 表示最高区间,自定义年龄可将最高区间下移到 18 岁以下。
  • 界限为 null、UNSPECIFIED 和错误均表示无信号,绝不视为成年人。
  • 0.0.6 的清单文件声明了 minSdk 24。
  • 将信号保留在您的应用中,并在不依赖该信号的情况下启动任何自建核验。

常见问题解答

我应该使用哪个版本的 Play Age Signals API?

使用 0.0.6。这是当前版本,全球可用,且 Google 表示将在 2026 年 12 月 11 日前为所有用户返回响应;在此期间 0.0.4 会继续在选定地区返回响应。[2]

我需要调用 getApplicableAgeFeatures 吗?

不需要,Google 将其标记为可选。当您的界面需要针对强制共享的用户显示不同内容时,可以调用该方法。[2]

NOT_SHARED 与 VERIFICATION_REQUIRED 有何区别?

NOT_SHARED 表示由于用户或家长未同意共享,您的应用未收到年龄信号。VERIFICATION_REQUIRED 表示在核验与共享均为强制要求的地区年龄未经验证,Google 提示您引导用户前往 Play Store。[2]

为什么两个界限均为 null?

当状态为 NOT_SHARED 或 VERIFICATION_REQUIRED 时,响应参考会给出 null 界限。[3]请将 null 界限视为无信号,切勿视为成年人。

为什么成年人的 ageUpper 为 null?

因为最高年龄段是开放式的:18+ 会返回 ageLower 18 以及 ageUpper null。[3]使用自定义年龄时,最高年龄段的起点可以更低,因此请将 ageLower 与您自己的最低年龄要求进行比对。

我可以设置自己的年龄范围吗?

可以,在 Play Console 的 Age signals 页面上最多可设置三个最低年龄,彼此间隔至少两年,每年可更改一次。它们会覆盖默认范围。[3]

在法律适用之前我该如何测试?

使用 FakeAgeSignalsManager 可返回任何状态、区间或错误,包括 MANDATORY_SHARING。许可测试人员账号允许侧载的调试版本调用正式 API。[6]

它能否在 Trusted Web Activity 或 WebView 中运行?

无法在网页代码中运行。它是一个通过 Activity 调用的 Android 库,我们查阅的 Google 页面未记录任何网页接口。包装应用需要其自身的原生代码,且 Google 条款将信息限制为仅供发起请求的应用使用。[2][5]

是否有 Unity、Flutter 或 React Native 插件?

存在社区和框架软件包。我们在 2026 年 11 月 22 日查阅的软件包声明为 0.0.4,因此它们缺少 getApplicableAgeFeatures。Unity 工作人员在 2025 年 12 月表示 Unity 不会发布专用插件。[17][18][19][20][21]

我可以将结果存储在我的服务器上吗?

Google 页面明确说明了可以在后端存储 installId 用于接收撤销通知。对于其余内容,仅在您自身系统内保留满足法定责任所需的最小结果,除非法律严格要求,否则切勿存入分析、广告或第三方服务中。[9][13]

参考来源

  1. Use Play Age Signals API (beta),Android Developers,更新于 2026 年 11 月 19 日。
  2. Request age signals,Android Developers,更新于 2026 年 11 月 18 日。
  3. Understand age signals responses,Android Developers,更新于 2026 年 11 月 18 日。
  4. Play Age Signals release notes,Android Developers,更新于 2026 年 11 月 19 日。
  5. Play Age Signals overview and terms of service,Android Developers,更新于 2026 年 11 月 18 日。
  6. Test your Play Age Signals API (beta) integration,Android Developers,更新于 2026 年 11 月 19 日。
  7. Play Age Signals API error code reference,Android Developers,更新于 2026 年 11 月 18 日。
  8. Notify Google Play of significant changes,Android Developers,更新于 2026 年 9 月 4 日。
  9. Review revoked app approvals,Android Developers,更新于 2026 年 9 月 4 日。
  10. AgeRangeSource reference,Android Developers,更新于 2026 年 11 月 18 日。
  11. com.google.android.play:age-signals,Google Maven;版本 0.0.3、0.0.4 和 0.0.6 的库清单与类于 2026 年 11 月 22 日读取。
  12. Use Play Age Signals API, version 0.0.3,Android Developers,更新于 2026 年 10 月 23 日。
  13. Age Signals API and User Data policy,Google Play Console Help。
  14. About age range sharing on Google Play,Google Play Help。
  15. AB 1856, Chapter 184, Statutes of 2026,California Legislative Information;修订 Civil Code 1798.500 至 1798.504。
  16. Regional age-related protections on Play,Android Developers,更新于 2026 年 11 月 18 日。
  17. Expo AgeRange,Expo 文档;软件包 expo-age-range 58.0.3。
  18. age_range_signals,pub.dev,2026 年 10 月 6 日的版本 0.10.1。
  19. react-native-play-age-range-declaration,GitHub,版本 3.0.5。
  20. unity-play-age-signals,GitHub,更新于 2026 年 8 月 4 日。
  21. Play Age Signals API Support,Unity Discussions,Unity 员工于 2025 年 12 月的回复。
  22. Code of Alabama 8-19K-9 (HB 161),Alabama Legislature。
  23. Utah Code 13-76-202,Utah Legislature;自 2027 年 5 月 6 日起的开发者义务。
  24. 2026 年 3 月 18 日 Decreto 12.880, art. 25,Planalto,巴西。
  25. Create session,Didit 文档。
  26. Android SDK,Didit 文档。
  27. Age Estimation 概览,Didit 文档。
  28. 生物识别知情同意,Didit 文档。
  29. Webhooks,Didit 文档。
  30. 数据保留,Didit 文档。
  31. 原生 SDK 概览,Didit 文档。
  32. FakeAgeSignalsManager 参考,Android Developers,更新于 2026 年 11 月 18 日。

上线这三个调用,测试表中的每一行,并将信号保留在 Google 条款规定的位置:您的应用内。对于它无法应答的分支,添加年龄估计作为您自己的核验手段。

为没有信号的用户添加核验

在您的应用中获取年龄估计演示,或立即创建工作流并启动会话。

预约演示免费开始

身份与欺诈基础设施。

一个 API 即可实现 KYC、KYB、交易监控和钱包筛选。5 分钟即可集成。

让 AI 总结此页面