ageRange.*

Overview

The Age Range plugin provides access to Apple’s Declared Age Range framework (iOS 26.0+) and Google’s Age Signals API (Android) for age verification and parental control management. This plugin helps apps comply with age-related regulations including state laws requiring parental consent for minors.

Syntax

local ageRange = require("plugin.ageRange")

Functions

Events

Project Settings

To use this plugin, add an entry into the plugins table of build.settings. When added, the build server will integrate the plugin during the build phase.

settings =
{
    plugins =
    {
        ["plugin.ageRange"] =
        {
            publisherId = "com.solar2d"
        },
    },
}

settings =
{
    iphone =
    {
        plist =
        {
            -- Required for Declared Age Range
            ["com.apple.developer.declared-age-range"] = true,
        },
    },
}

Sample Code

local ageRange = require("plugin.ageRange")

local function ageRangeListener(event)
    if event.name == "ageRangeEvent" then
        if event.isError then
            print("Error:", event.errorMessage)
        elseif not event.isAvailable then
            print("Age range not available")
        elseif event.declined then
            print("User declined to share age range")
        else
            print("Age range received:")
            print("  Lower bound:", event.lowerBound)
            print("  Upper bound:", event.upperBound)
            print("  User status:", event.userStatus)
            
            if event.userStatus == "verified" then
                -- User is 18+, grant full access
            elseif event.userStatus == "supervised" then
                -- User has parental controls, restrict content
            end
        end
        
    elseif event.name == "significantUpdateEvent" then
        if event.questionSent then
            print("Update permission request sent")
        elseif event.approved then
            print("Update approved by parent")
        end
        
    elseif event.name == "communicationEvent" then
        if event.questionSent then
            print("Communication request sent")
        elseif event.approved then
            print("Communication approved by parent")
        end
    end
end

-- Initialize the plugin
ageRange.init(ageRangeListener)

-- Request age range
ageRange.requestAgeRange()

Support

• GitHub: https://github.com/solar2d/plugin.ageRange
• Documentation: https://docs.coronalabs.com/plugin/ageRange