@capgo/ 电容- 机器人- usagestatsmanager

从您的 Capacitor app 读取 Android 应用程序使用统计 UsageStatsManager API:每个应用程序的屏幕时间,使用间隔和原始使用事件. 用于数字福利,家长控制和分析应用.

🤖 建筑与AI编码代理? 安装 Capgo 技能 所以克劳德代码,代码,光标,副驾驶,或双子座CLI知道如何安装和使用 @capgo/capacitor-android-usagestatsmanager 在您的电容应用程序中: npx skills add Cap-go/capgo-skills。然后问你的经纪人: 添加@capgo/capor-android-usagestatsmanager到我的Capacitor应用软件上,并把它接上。" 代理设置指南 • 妇女 主机磁共振

主要特点

• 总使用数字 : queryAndAggregateUsageStats() 返回时间范围的每个应用程序使用.
• 数据间隔数字 : queryUsageStats() 返回每日、每周、每月或每年间隔的数据.
• 原始活动数字 : queryEvents() 读取一个时间范围的使用事件日志.
• 已安装的应用程序数字 : queryAllPackages() 列出安装在设备上的软件包.
• 权限助手数字 : isUsageStatsPermissionGranted() 财务报告和审定财务报表 openUsageStatsSettings() 指导用户允许使用.
• 平台:Android (英语). 仅限Android. 网络方法抛出.

说明

将Android的用法Stats Manager SDK 曝光给控制器

为什么是Android UsageStats Manager?. 中国植物物种信息数据库?

唯一显示 Android 的插件 用法Stats 管理者 API 到 Capacitor - 此Android API 在之前没有被任何插件支持 :

• App 用户跟踪 - 监视哪些应用软件打开用户并持续多久
• 屏幕时间分析 - 建立父母控制和数字福利功能
• 确切窗口事件 - 在需要将前景时间剪接到特定范围时,查询原始生命周期事件
• 软件包信息 - 查询设备上安装的所有应用程序
• 时间查询 - 获取任何时间范围内的数据

适合家长控制应用程序、数字福利工具、生产力跟踪器和屏幕时间管理器.

使用量

需要下列权限: AndroidManifest.xml数字 :

<uses-permission android:name="android.permission.PACKAGE_USAGE_STATS"
    tools:ignore="ProtectedPermissions" />
<uses-permission android:name="android.permission.QUERY_ALL_PACKAGES"
    tools:ignore="QueryAllPackagesPermission" />

文档

这里有最完整的医生: https://capgo.app/docs/plugins/android-usagestatsmanager/ 互联网档案馆的存檔,存档日期2013-12-20

兼容性

说明: 此插件的主要版本沿用了Capacitor的主要版本. 使用匹配您的 Capacitor 安装的版本( 如 Capacitor 8 的插件 v8) 。 只有最新的主要版本得到积极维护.

安装

您可以使用我们的 AI 辅助设置安装插件 。 使用以下命令将 Capgo 技能添加到您的 AI 工具 :

npx skills add https://github.com/cap-go/capacitor-skills --skill capacitor-plugins

然后使用下列提示:

Use the `capacitor-plugins` skill from `cap-go/capacitor-skills` to install the `@capgo/capacitor-android-usagestatsmanager` plugin in my project.

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

npm install @capgo/capacitor-android-usagestatsmanager
npx cap sync

API 密码

• queryAndAggregateUsageStats(...)
• queryUsageStats(...)
• queryEvents(...)
• isUsageStatsPermissionGranted()
• openUsageStatsSettings()
• queryAllPackages(...)
• getPluginVersion()
• 接口
• 类型异名

用于访问Android UsageStatsManager API的电容插件.

查询AggregateUsageStats(...)

queryAndAggregateUsageStats(options: UsageStatsOptions) => Promise<Record<string, UsageStats>>

为给定时间范围查询和汇总使用数据.

Android每日/每周/每月/每年读取预先汇总的桶和款项 每个相交的桶 [beginTime, endTime)没有剪辑它. totalTimeInForeground 因此可以包括窗口外的用法. 使用 queryUsageStats 用于未浮出水面的每桶,或 queryEvents 用于在请求范围内进行时间标记的生命周期事件.

回返情况: Promise<Record<string, UsageStats>>

自: 1.0.0 (单位:千美元)

查询UsageStats(...)

queryUsageStats(options: QueryUsageStatsOptions) => Promise<QueryUsageStatsResult>

查询给定间隔类型和时间范围的用法统计.

环绕Android UsageStatsManager.queryUsageStats不同 queryAndAggregateUsageStats,不合并桶:结果为 一个 UsageStats 对象每包每相重叠间隔。 Android 可能会 扩展 [beginTime, endTime) 到最近的整个间隔期,所以 totalTimeInForeground 可包括窗口外的用法.

在Android R(API 30)及以上上,OS在用户为时不返回数据 锁定; 此插件随后解析 { stats: [] },不能对其进行处理 以0 为前景用法.

这个用同一种 PACKAGE_USAGE_STATS 允许为 queryAndAggregateUsageStats。 。 。 .

回返情况: Promise<QueryUsageStatsResult>

自: 8.1.3 (中文(简体) )

查询事件(...)

queryEvents(options: QueryEventsOptions) => Promise<QueryEventsResult>

查询指定时间范围的原始使用事件日志.

返回时间戳入的生命周期事件 [beginTime, endTime)。 。 。 . Android没有发出一个合成事件 用于"已经出现在前方 开始时间"或"在结束时间仍然处于前景". 衡量跨度 这些界限,通过一个较早的 beginTime 作为本地回首和剪接: 将未匹配的暂停作为窗口启动时开始, 和未匹配 恢复为结束于窗口端.

Android只保留了几天的事件. 长距离可能返回 不完整或为空的列表; 与 0 前置使用不相同 . 在Android R(API 30)及以上时,OS也会在Android R(API 30)及以上时不返回事件 用户被锁定;然后此插件解析 { events: [] },同样 不得作为零前台使用.

呼叫者可以将返回的事件恢复到暂停的间隔相加. 不要治疗 DEVICE_SHUTDOWN 作为暂停:它是一个重设的标记,而不是一个 间隔接近 。 这个用同一种 PACKAGE_USAGE_STATS 允许为 queryAndAggregateUsageStats。 。 。 .

只有生命周期事件才能返回,以保持桥载荷的小型:

• 1 活动/活动
• 2 ——活动 提供/移动 TO BACKGRUND
• 23 活动
• 26 —— DEVICE SHUTDOWN( 设备宽重置标记; 仍然返回时 packageName 已经设定。 Android 通常报告软件包 "android"。 。 。 . packageName 如果操作系统不附加一个,则省略。 时间戳 是最后一个 使用数据 关闭前持续,而非实际 电源关闭。 打开恢复事件而不匹配此间暂停 标记和下一个靴子的期限不明,必须被忽略。 )

回返情况: Promise<QueryEventsResult>

自: 8.1.3 (中文(简体) )

是UsageStats 授权加兰特 ()

isUsageStatsPermissionGranted() => Promise<UsageStatsPermissionResult>

检查是否允许使用数据 .

回返情况: Promise<UsageStatsPermissionResult>

自: 1.0.0 (单位:千美元)

打开用户定义

openUsageStatsSettings() => Promise<void>

打开使用 STAS 设置屏幕 . 这将打开使用 STATs 设置屏幕, 允许用户批准使用 STATs 权限 . 这将总是打开设置屏幕, 即使已经获得许可 .

自: 1.0.0 (单位:千美元)

查询 AllPackages (...)

queryAllPackages(options?: QueryAllPackagesOptions | undefined) => Promise<{ packages: PackageInfo[]; }>

查询设备上安装的所有软件包. 需要QUERY ALL PACKAGES许可.

回返情况: Promise<{ packages: PackageInfo[]; }>

自: 1.2.0 (中文(简体) )

获取 PluginVersion ()

getPluginVersion() => Promise<{ version: string; }>

获取本地 Capacitor 插件版本 .

回返情况: Promise<{ version: string; }>

自: 1.0.0 (单位:千美元)

接口

使用数据

Android应用软件的使用统计.

用法Stats 选项

查询使用统计的选项 .

查询UsageStats Result 数据

其结果a queryUsageStats 电话.

查询UsageStats 选项

按间用统计查询选项.

查询事件结果

其结果a queryEvents 电话.

用法活动

代表单一使用事件.

queryEvents 当前分布 className, (中文(简体) ), timeStamp,以及 eventType。 。 。 . packageName 当Android附加一个时设定(DEVICE SHUTDOWN 通常使用 "android")而省略了其他内容。 其他字段仍然可选 兼容性.

查询结果选项

查询原始使用事件日志的选项 .

用法Stats 任务结果

使用量统计权限检查的结果 .

软件包信息

代表一个已安装软件包的基本信息.

查询所有套件选项

查询已安装软件包的选项 .

类型异名

记录

构造 T 类型 K 的一组属性类型

{ [P in K]: T; }