Expo AgeRange

重要 该库目前处于 alpha 版本，可能经常出现重大更改。

expo-age-range 提供用户年龄范围信息的访问权限。它在 Android 上使用 Google 的 Play Age Signals API，在 iOS 上使用 Apple 的 Declared Age Range framework。

这个库允许你从应用用户那里请求年龄范围信息，以帮助你遵守适龄内容规定（例如在美国德克萨斯州）并在你的应用中提供适合年龄的体验。

🌐 This library allows you to request age range information from your app users to help you comply with age-appropriate content regulations (such as in Texas, USA) and provide age-appropriate experiences in your app.

局限性

🌐 Limitations

我们强烈建议在真实设备上测试功能，因为模拟器运行时可能无法按预期工作。

🌐 We strongly recommend testing the functionality on a real device, as simulator runtimes may not work as expected.

在 Android 上，根据官方 Android 文档，Play Age Signals API（测试版）可能会抛出异常，直到 2026 年 1 月 1 日。从 1 月 1 日起，该 API 将返回实时响应。

🌐 On Android, the Play Age Signals API (beta) may throw an exception until January 1, 2026, as per the official Android documentation. From January 1, the API will return live responses.

安装

🌐 Installation

If you are installing this in an existing React Native app, make sure to install expo in your project.

应用配置中的配置

🌐 Configuration in app config

设置 iOS 项目

🌐 Setup iOS project

要在 iOS 上使用年龄范围 API，你需要使用 Xcode 26.0 或更高版本构建项目。需要 com.apple.developer.declared-age-range 权限。将其添加到你的 应用配置 文件中：

🌐 To use the age range API on iOS, you need to build your project with Xcode 26.0 or later. The com.apple.developer.declared-age-range entitlement is required. Add it to your app config file:

{
  "expo": {
    "ios": {
      "entitlements": {
        "com.apple.developer.declared-age-range": true
      }
    }
  }
}

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

用法

🌐 Usage

import * as AgeRange from 'expo-age-range';
import { useState } from 'react';
import { StyleSheet, Text, View, Button } from 'react-native';

export default function App() {
  const [result, setResult] = useState<AgeRange.AgeRangeResponse | { error: string } | null>(null);

  const requestAgeRange = async () => {
    try {
      const ageRange = await AgeRange.requestAgeRangeAsync({
        threshold1: 10,
        threshold2: 13,
        threshold3: 18,
      });
      setResult(ageRange);
    } catch (error) {
      setResult({ error: error.message });
    }
  };

  return (
    <View style={styles.container}>
      <Button title="请求年龄范围" onPress={requestAgeRange} />
      {result && (
        <Text style={styles.result}>
          {'error' in result ? `Error: ${result.error}` : `Lower age bound: ${result.lowerBound}`}
        </Text>
      )}
    </View>
  );
}

const styles = StyleSheet.create({
  container: {
    flex: 1,
    justifyContent: 'center',
    padding: 20,
  },
  result: {
    marginTop: 20,
    fontSize: 16,
  },
});

其他资源

🌐 Additional resources

• Play 年龄信号 API：Android 年龄信号文档
• 声明年龄范围框架：iOS 声明年龄范围的文档

应用接口

🌐 API

import * as AgeRange from 'expo-age-range';

Methods

Types

错误代码

🌐 Error codes

可在本地模块抛出的任何错误的 code 属性中获取。有关 Android 特定的错误代码，请参见 使用 Play Age Signals API 文档 中的“处理 API 错误代码”。

🌐 Available in the code property of any error thrown by the native module. For Android-specific error codes, see "Handle API error codes" in Use Play Age Signals API docs.