App 健康管理组件 Android 健康提醒组件

简介

健康管理是针对 APP 使用者的一个提醒功能，是娱乐型 APP 中常用的功能！ 该组件包含如下功能：

• 1.周期性提醒功能，比如用户使用半小时之后提醒一次
• 2.夜深提醒功能，比如超过晚上九点半使用 APP，提醒用户太晚了

效果截图

• 周期性提醒页面

• 深夜提醒页面

引入组件

Step 1 Add it in your root build.gradle at the end of repositories:

allprojects {
        repositories {
            ...
            maven { url 'https://jitpack.io' }
        }
    }

Step 2 Add the dependency

dependencies {
            implementation 'com.github.MZCretin:HealthManager:v1.0.0'
}

Step3 Init SDK

Initialization on the BaseApplication is recommended.

        var startHour = 21
        var startMinute = 0
        var startSecond = 0
        var endHour = 6
        var endMinute = 0
        var endSecond = 0
        var overDay = 1
        var appUseLimit = 1800
        var backgroundTime = 300

        //健康管理
        val config = HMConfig
            //创建配置
            .createConfig()
            //设置环境 debug 环境有日志输出 TAG 为 HealthManagerSDK
            .isDebug(BuildConfig.DEBUG)
            //设置允许 APP 在后台被计时的最长时间，比如设置 5 分钟，那么应用处于后台超过 5 分钟，就清空之前的计时，下次进入 app 就从头开始计时，否则就继续计时
            .setMaxInBackgroundTime(backgroundTime)
            //设置单次可使用的最长时间，当超过这个时间就会弹窗提醒
            .setStudyTimeLimit(appUseLimit)
            //设置欢迎页面，因为在这个页面不能显示健康管理弹窗 没有欢迎页面就不设置
            .setAppSplashActivity(SplashActivity::class.java)
            //设置周期性弹窗的 ui 有一点需要注意，在你自定义的布局文件中，点击关闭的页面或者按钮的 id 需要是 id_health_ok，id_health_ok_v2, id_health_ok_v3, id_health_ok_4 中的一个或几个
            .setLayoutCover(R.layout.activity_health_manager_cover)
            //设置夜深了弹簧 ui  有一点需要注意，在你自定义的布局文件中，点击关闭的页面或者按钮的 id 需要是 id_health_ok，id_health_ok_v2, id_health_ok_v3, id_health_ok_4 中的一个或几个
            .setLayoutDialog(R.layout.activity_health_manager_dialog)
            //设置夜深模式信息 即设置夜深模式开始的时间和结束时间 dailyNightModeOverDay 指的是你设置的时间是否是跨越当日的
            //比如你设置深夜时间指的是当天晚上 21：00 到次日 06：00 那就是 startHour = 21 startMinute = 0 startSecond = 0 endHour = 6  endMinute = 0 endSecond = 0 dailyNightModeOverDay = true
            //比如你设置深夜时间指的是当天晚上 21：00 到次日当天晚上 23：00 那就是 startHour = 21 startMinute = 0 startSecond = 0 endHour = 23  endMinute = 0 endSecond = 0 dailyNightModeOverDay = false
            .setNightModeInfo(
                startHour,
                startMinute,
                startSecond,
                endHour,
                endMinute,
                endSecond,
                overDay == 1
            )
        //初始化
        HealthManager.init(this, config)