电容时代信号插件

使用该电容的插件 播放时代信号 API (机器人)和 已宣布为 年龄范围 (iOS)请求用户的年龄信号.

特征

Capacitor Age Signals插件是Capacitor App最完整的年龄保证解决方案之一. 以下是一些关键特征:

• 🖥️ 跨平台: 支持Android和iOS.
• 🔍 年龄核查:使用Play Age Signals API(Android)和"宣布"(iOS)请求用户年龄信号.
• 👨‍👩‍👧‍👦 家长控制支持具有父母批准地位的受监督账户.
• 🧪 测试支持: 内建 FakeAgeSignalsManager 用于测试不同年龄验证情景的整合(Android).
• 🌍 准备就绪: 为美国国家年龄核查要求所建(2026年1月1日生效).
• 🤝 兼容性: 与 App 完整性 财务报告和审定财务报表 根检测 插件 .
• 📦 可可花和SPM:支持CocoaPods和Swift软件包管理器用于iOS.
• 🔁 最新数据:总是支持最新的Capacitor版本.

缺少一个功能? 刚刚 打开一个问题 我们看看!

使用大小写

Age Signals插件通常用于遵守年龄验证要求,并针对用户的年龄调整应用体验,例如:

• 按年龄划分的内容: 根据用户的验证状态和年龄范围,限制获取成熟或敏感内容.
• 监管遵守情况:通过从Google Play和苹果的"宣布年龄"API中请求年龄信号来达到美国州年龄验证要求.
• 父母监督: 检测有监督的账户,并对有待或被拒绝的家长批准作出反应.
• 区域资格检查: 使用 getRegulatoryRequirements() 在iOS上确定用户是否在一个区域有额外的与年龄有关的义务.
• 自动化测试: 使用内置的假管理器在您的安卓测试中模拟不同的年龄验证方案.

兼容性

安装

你可以用我们的 AI 辅助设置 以安装插件. 添加数据 超级技能 至您的 AI 工具,使用以下命令:

npx skills add capawesome-team/skills --skill capacitor-plugins

然后使用下列提示:

 Use the `capacitor-plugins` skill from `capawesome-team/skills` to install the `@capawesome/capacitor-age-signals` plugin in my project.

如果你喜欢 手动设置,通过运行以下命令来安装插件,并遵循下面的平台特定指令:

npm install @capawesome/capacitor-age-signals
npx cap sync

机器人

变量

如果需要, 您可以在您的应用程序中定义以下工程变量 variables.gradle 要更改依赖的默认版本的文件 :

• $androidPlayAgeSignalsVersion 版本 com.google.android.play:age-signals (默认 : 0.0.4(中文(简体) )

如果您在工程中遇到其它插件的依赖性冲突, 这会有所帮助 .

说明编号: FakeAgeSignalsManager 测试 API 包含在主 age-signals 因此测试不需要额外的依赖.

iOS系统

应享权利

要使用已宣布的年龄 API, 您必须启用 com.apple.developer.declared-age-range 在应用程序的应享权利文件中添加以下密钥:

<key>com.apple.developer.declared-age-range</key>
<true/>

看看这个 苹果文档 更多信息.

配置

此插件不需要配置 .

使用量

以下例子说明了如何要求用户的年龄范围以及如何对适用于用户的监管要求作出反应.

请求用户的年龄范围

打电话 requestAgeRange(...) 请用户分享他们的年龄范围。 状态说明年龄范围是否相同 ageRange 属性包含边框 :

import { AgeRangeStatus, AgeSignals } from '@capawesome/capacitor-age-signals';

const requestAgeRange = async () => {
  const result = await AgeSignals.requestAgeRange();
  if (result.status !== AgeRangeStatus.Shared) {
    console.log('The user has not shared their age range:', result.status);
    return;
  }
  console.log('Lower Bound:', result.ageRange?.lowerBound);
  console.log('Upper Bound:', result.ageRange?.upperBound);
};

在Android上,状态为 VERIFICATION_REQUIRED 表示用户必须在Google Play Store中解决其状态后才能共享一个年龄范围.

在不提示的情况下读取年龄范围

打电话 getAgeRange() 在不显示提示的情况下再次读取年龄范围。 这对民意调查很有用 significantChange 从 PENDING 改为 APPROVED。仅在Android上提供:

import { AgeSignals } from '@capawesome/capacitor-age-signals';

const getAgeRange = async () => {
  const result = await AgeSignals.getAgeRange();
  console.log('Significant Change:', result.significantChange?.status);
};

检查监管要求

检查用户是否处于需要年龄保证的区域和账户状态,以及您的应用程序必须支持哪些监管功能. 仅在iOS上可用 :

import {
  AgeSignals,
  RegulatoryFeature,
} from '@capawesome/capacitor-age-signals';

const getRegulatoryRequirements = async () => {
  const result = await AgeSignals.getRegulatoryRequirements();
  if (
    result.regulatoryFeatures.includes(
      RegulatoryFeature.SignificantAppChangeRequiresAdultNotification,
    )
  ) {
    await AgeSignals.showSignificantUpdateAcknowledgment({
      updateDescription: 'This app now supports direct messages between users.',
    });
  }
};

API 密码

• getAgeRange()
• getRegulatoryRequirements()
• isAvailable()
• requestAgeRange(...)
• setNextAgeSignalsAccessResult(...)
• setNextAgeSignalsException(...)
• setNextAgeSignalsResult(...)
• setNextRequestAgeSignalsAccessException(...)
• setUseFakeManager(...)
• showSignificantUpdateAcknowledgment(...)
• 接口
• 数字

获取年龄范围 ()

getAgeRange() => Promise<GetAgeRangeResult>

获取用户已经与应用程序共享的年龄范围 .

这种方法从未显示系统提示 。 打电话 requestAgeRange(...) 第一个 如果返回状态为 SHARED。 。 。 .

使用这种方法对变化进行投票(例如: significantChange 从 PENDING 改为 APPROVED)而不提示用户 再来一次.

只能从Android上找到.

回返情况: Promise<GetAgeRangeResult>

自: 0.5.0 (单位:千美元)

获取监管要求( )

getRegulatoryRequirements() => Promise<GetRegulatoryRequirementsResult>

获取适用于当前用户的监管要求.

在开始任何年龄保证流程前拨打此方法以查找 用户是否处于一个地区和账户状态,其年龄保障 完全适用.

仅在iOS上提供(26.2+).

回返情况: Promise<GetRegulatoryRequirementsResult>

自: 0.5.0 (单位:千美元)

易读 ()

isAvailable() => Promise<IsAvailableResult>

检查此设备是否有年龄信号 .

打开 机器人,此检查是否安装了 Google Play Store . 打开 iOS系统,此选项检查该设备是运行iOS 26.0还是运行后.

结果是 true 并不保证可以检索一个年龄范围. 总是处理其他方法的错误.

回返情况: Promise<IsAvailableResult>

自: 0.5.0 (单位:千美元)

请求AgeRange(...)

requestAgeRange(options?: RequestAgeRangeOptions | undefined) => Promise<RequestAgeRangeResult>

请用户与应用程序共享他们的年龄范围 .

这种方法可能显示系统提示 。 系统缓存 用户,所以后续的调用可能无需任何用户交互即可解决.

打开 机器人,该提示只显示给未受监督的用户 选择在共享前被询问。 年龄地区没有显示 核查是强制性的。 在这种情况下,情况是: VERIFICATION_REQUIRED 用户必须解决其在 谷歌游戏商店. Google Play 还压制了用户之后的提示 曾几次驳回或拒绝. 打开 iOS系统,在年龄保障的区域没有显示提示 强制。 在这种情况下,年龄范围在没有用户互动的情况下共享.

回返情况: Promise<RequestAgeRangeResult>

自: 0.5.0 (单位:千美元)

设置NextAgeSignals AccessResult(...)

setNextAgeSignalsAccessResult(options: SetNextAgeSignalsAccessResultOptions) => Promise<void>

设定由假管理器返回的下一个访问结果 .

只能从Android上找到.

自: 0.5.0 (单位:千美元)

设置近代符号例外(...)

setNextAgeSignalsException(options: SetNextAgeSignalsExceptionOptions) => Promise<void>

当年龄范围是时, 设置由假管理器丢出的下一个错误 读取.

只能从Android上找到.

自: 0.3.1 (中文(简体) )

设置 NextAgeSignals Result (...)

setNextAgeSignalsResult(options: SetNextAgeSignalsResultOptions) => Promise<void>

设定由假管理器返回的下一个年龄范围结果 .

只能从Android上找到.

自: 0.3.1 (中文(简体) )

设置下一个请求年龄符号访问例外(...)

setNextRequestAgeSignalsAccessException(options: SetNextRequestAgeSignalsAccessExceptionOptions) => Promise<void>

设定访问年龄时由假管理器丢出下一个错误 区域请求.

只能从Android上找到.

自: 0.5.0 (单位:千美元)

设置使用假管理器(...)

setUseFakeManager(options: SetUseFakeManagerOptions) => Promise<void>

启用或禁用假管理器进行测试 .

假管理器只在可调试的架构中可用 。 在发行中建造 此方法拒绝使用 FAKE_MANAGER_NOT_ALLOWED因为它会 否则可以让年龄信号从网络层被伪造出来.

只能从Android上找到.

自: 0.3.1 (中文(简体) )

显示显著的更新日期

showSignificantUpdateAcknowledgment(options: ShowSignificantUpdateAcknowledgmentOptions) => Promise<void>

显示系统接口, 让用户识别一个显著 更改为应用程序 .

仅在下列情况下调用此方法: getRegulatoryRequirements() 已返回 SIGNIFICANT_APP_CHANGE_REQUIRES_ADULT_NOTIFICATION。 。 。 .

仅在iOS上提供(26.4+).

自: 0.5.0 (单位:千美元)

接口

获取年龄分布结果

年龄范围

重大变化

获取监管要求

易伤性结果

请求年龄范围

请求年龄范围选项

设置最近年龄符号访问结果选项

设定最近的年龄符号例外选项

设置最近的年龄符号结果选项

设定下一个请求年龄符号访问例外选项

设置使用假管理选项

显示显著更新日期

数字

家长控制

年龄范围宣言

年龄距离来源

重大变化状况

规范特性

年龄范围状况

错误代码

测试

插件包括支持 FakeAgeSignalsManager 在Android上的API,它允许您在测试中模拟不同的年龄信号情景,而不需要Google Play的现场响应.

Android 测试

重要: 假管理器只有在您的应用程序可以调试时才可用 。 释放过程中, setUseFakeManager(...) 拒绝方式 FAKE_MANAGER_NOT_ALLOWED因为它会让年龄信号从网络层被铸造出来.

重要: 由于时代信号API的0.0.1和0.0.2版本中已知的一出,您可能会遇到一个 java.lang.VerifyError 当调用构建方法时 AgeSignalsResult 在单位测试。 作为一个工作,运行你的测试 作为Android仪器测试 androidTest 源设置.

示例:测试自声明的成人用户

import {
  AgeRangeSource,
  AgeRangeStatus,
  AgeSignals,
} from '@capawesome/capacitor-age-signals';

// Enable the fake manager
await AgeSignals.setUseFakeManager({ useFake: true });

// The user agrees to share their age range
await AgeSignals.setNextAgeSignalsAccessResult({
  status: AgeRangeStatus.Shared,
});

// Set up an adult user
await AgeSignals.setNextAgeSignalsResult({
  ageLower: 18,
  ageRangeSource: AgeRangeSource.TierA,
});

const result = await AgeSignals.requestAgeRange();
console.log(result.status); // 'SHARED'
console.log(result.ageRange?.lowerBound); // 18

示例:测试一个监督用户(13至17岁)

import {
  AgeRangeSource,
  AgeRangeStatus,
  AgeSignals,
} from '@capawesome/capacitor-age-signals';

await AgeSignals.setUseFakeManager({ useFake: true });

await AgeSignals.setNextAgeSignalsAccessResult({
  status: AgeRangeStatus.Shared,
});

await AgeSignals.setNextAgeSignalsResult({
  ageLower: 13,
  ageUpper: 17,
  ageRangeSource: AgeRangeSource.TierB,
  installId: 'fake_install_id',
});

const result = await AgeSignals.requestAgeRange();
console.log(result.ageRange?.lowerBound); // 13
console.log(result.ageRange?.upperBound); // 17
console.log(result.installId); // 'fake_install_id'

示例:测试父母批准方案

import {
  AgeRangeSource,
  AgeRangeStatus,
  AgeSignals,
  SignificantChangeStatus,
} from '@capawesome/capacitor-age-signals';

await AgeSignals.setUseFakeManager({ useFake: true });

await AgeSignals.setNextAgeSignalsAccessResult({
  status: AgeRangeStatus.Shared,
});

// Test pending approval
await AgeSignals.setNextAgeSignalsResult({
  ageLower: 13,
  ageUpper: 17,
  ageRangeSource: AgeRangeSource.TierB,
  significantChangeApprovalDate: '2026-02-01T00:00:00.000Z',
  significantChangeStatus: SignificantChangeStatus.Pending,
});

const result = await AgeSignals.requestAgeRange();
console.log(result.significantChange?.status); // 'PENDING'
console.log(result.significantChange?.approvalDate); // '2026-02-01T00:00:00.000Z'

示例:测试必须验证其年龄的用户

import { AgeRangeStatus, AgeSignals } from '@capawesome/capacitor-age-signals';

await AgeSignals.setUseFakeManager({ useFake: true });

await AgeSignals.setNextAgeSignalsAccessResult({
  status: AgeRangeStatus.VerificationRequired,
});

const result = await AgeSignals.requestAgeRange();
console.log(result.status); // 'VERIFICATION_REQUIRED'
console.log(result.ageRange); // undefined

示例:测试出错情景

import { AgeSignals, ErrorCode } from '@capawesome/capacitor-age-signals';

await AgeSignals.setUseFakeManager({ useFake: true });

// Simulate a network error while access is requested
await AgeSignals.setNextRequestAgeSignalsAccessException({
  errorCode: ErrorCode.NetworkError,
});

try {
  await AgeSignals.requestAgeRange();
} catch (error) {
  console.log('Caught network error:', error);
}

// Simulate a network error while the age range is read
await AgeSignals.setNextAgeSignalsException({
  errorCode: ErrorCode.NetworkError,
});

try {
  await AgeSignals.getAgeRange();
} catch (error) {
  console.log('Caught network error:', error);
}

禁用假管理器

import { AgeSignals } from '@capawesome/capacitor-age-signals';

// Switch back to the production manager
await AgeSignals.setUseFakeManager({ useFake: false });

// This will now use the real Age Signals API
const result = await AgeSignals.requestAgeRange();

财务问题

此插件使用哪个年龄验证 API ?

在Android上,插件使用 播放时代信号 API 从 Google Play 请求年龄信号。 在iOS上,它使用苹果公司的 已宣布为 年龄范围 框架,其中要求 com.apple.developer.declared-age-range 应享权利(见 安装) (中文(简体) ).

不同的状态是什么意思?

这个 status 属性告诉用户是否共享他们的年龄范围. SHARED 表示有年龄范围, NOT_SHARED 表示用户拒绝或不在一个适用区域,以及 VERIFICATION_REQUIRED (Android只)指用户必须先解决其在Google Play Store的地位.

Android年龄范围来源如何映射到iOS年龄范围声明??

Android)报告一个年龄被确定为分级,而iOS则报告一种宣布方法. 它们不绘制一到一的映射图,因此两个值都作为单独的属性被曝光. 下表列出最接近的等同物:

在iOS 26.5 及以后,颗粒性较强的申报可能被替换为: CONFIRMED,涵盖两个 TIER_C 财务报告和审定财务报表 TIER_D。 。 。 .

我如何测试不同年龄的核实情况?

在Android上,插件集成了 FakeAgeSignalsManager API,它让你模拟年龄信号,而不用Google Play的活回音. 启用它 setUseFakeManager(...) 并设定下一个结果或例外 setNextAgeSignalsAccessResult(...), (中文(简体) ), setNextAgeSignalsResult(...), (中文(简体) ), setNextRequestAgeSignalsAccessException(...) 财务报告和审定财务报表 setNextAgeSignalsException(...)。假管理器只有在您的应用程序可以调试时才可用 。 见 测试 一节,用于完整示例.

为什么我在Android单位的测试中 得到验证错误?

由于"时代信号API"0.0.1和0.0.2版本中已知的一出,称为"构建者"方法 AgeSignalsResult 单位测试中可投出 java.lang.VerifyError作为工作,将你的测试作为Android仪器测试 androidTest 源设置.

为什么插件以 API NOT AVAILALED 或 APP NOT OWNED 等错误拒绝 ?

Play Age Signals API 需要设备上最新的 Play Store 应用程序和 Play 服务,所以错误如 API_NOT_AVAILABLE, (中文(简体) ), PLAY_STORE_VERSION_OUTDATED,或 PLAY_SERVICES_NOT_FOUND 通常表示已过时或缺失的Google Play组件. 这个 APP_NOT_OWNED 错误指该应用程序不是由Google Play安装的. 检查 ErrorCode 语句 API 密码 一节,用于完整错误代码列表.

我能用这个插件吗? 有Ionic、React、Vue或Angular?

是的,插件是框架不可知的。 它在任意网络框架的Capacitor app中工作,包括有Angular,React,或Vue的Ionic,以及平版JavaScript等项目.

相关插件

• App 完整性: 使用 Play Guide API 和 App Attest 验证应用及设备完整性.
• App 跟踪透明度:通过Apple的App跟踪透明框架请求用户授权.
• 根检测: 检测出有根有根和断裂的装置.

通讯

随时更新有关卡帕韦索姆、Capacitor和Ionic生态系统的最新消息和最新消息,因为我们 《卡帕索克通讯》。 。 。 .

更改日志

见 变动情况。 。 。 .

许可证

见 自由主义。 。 。 .