从下载安装到各项功能设置,带你完整了解 PushMe 的使用方法
前往 下载页面,下载 PushMe APK 文件并安装到安卓手机上。首次打开 APP 即可直接使用,无需登录注册。
点击左上角 设置图标 打开侧边栏,展开 "push_key" 区域,点击 "获取" 按钮。获取成功后,即可使用接口推送消息到手机。详见 Push Key。
通过 HTTP 请求向接口发送消息,即可在手机收到通知。你可以直接在 首页在线测试 发送,也可以用代码调用接口。
curl -d "push_key=你的push_key&title=你好&content=这是第一条消息" https://push.i-i.me
为了保证消息能稳定送达,请务必在侧边栏 → 权限设置 中配置好自启动、电池优化、消息通知等权限。
侧边栏 → push_key
push_key 是你接收消息的唯一标识,相当于你的「收件地址」。首次使用时,展开 push_key 区域点击 获取,确认后 APP 会自动向服务器申请一个专属 key。获取成功后,其他人即可通过接口向这个 key 推送消息,消息会实时到达你的手机。
已获取过 key 后,按钮会变为 更换。更换会申请一个全新的 key,旧的 key 随即失效。
侧边栏 → 消息设置,用于调整消息列表的显示与交互方式。
开启后,带分组的消息会统一置顶显示在列表最上方,方便优先查看重要来源的消息。默认关闭。
开启后,所有没有分组的消息会被归入一个虚拟分组中合并展示,让消息列表更整洁。默认关闭。
设置点击一条分组消息时进入的页面:
拖动滑块调整消息列表的字体缩放比例,默认 1.0。字体偏小或偏大的用户可以按需调整。
开启后,消息列表滚动到底部时会自动加载更早的历史消息;关闭时需手动点击「加载更多」。默认关闭。
设置消息里链接的打开方式:系统 表示用系统浏览器打开(默认),PushMe 表示在 APP 内置页面中打开。
设置是否允许执行 HTML 消息中携带的 JavaScript 脚本。出于安全考虑,默认 禁用;只有在你完全信任消息来源时,才建议开启。
设置新收到的消息默认标记为 未读(默认)还是 已读。默认未读,便于在列表中区分未查看的新消息。
侧边栏 → 服务设置,管理消息的接收服务与扩展能力。
开启后,手机在局域网内会启动一个本地 HTTP 接口服务,同一网络下的设备可直接把消息 POST 到手机,无需经过云端服务器,实现局域网消息直达。
0.0.0.0,监听所有网卡3010http://[地址]:[端口]/,参数 push_key、title、content、date、type;POST 请求体支持 JSON 或表单格式。PushMe 的消息接收核心服务,决定消息从哪里接收:
当你选择「自建」消息服务时,在此配置自己的服务器。部署方式见 PushMeServer 文档。
3100插件可在消息到达时对其进行验签、解密、加工处理,基于 JavaScript 编写。点击「设置」进入插件管理页,可新增、编辑、启用 / 禁用插件。详见 插件开发文档。
把收到的消息通过 HTTP POST 转发到指定 URL,可将消息同步到电脑或其他系统。点击「设置」进入转发配置页。详见 PushMeClient 文档。
开启后,核心服务会以「前台服务」方式常驻运行,并在通知栏显示一条不可划掉的服务通知。它可以显著减少因后台被系统冻结而导致的 MQTT 频繁掉线,代价是略微增加耗电。默认关闭。
侧边栏 → APP 设置,个性化外观与通知行为。
设置 APP 界面语言,默认跟随系统。切换语言后需重启 APP 生效。
设置 APP 的明暗主题,默认跟随系统。
设置是否在系统的最近任务列表中显示 PushMe。默认显示;选择「隐藏」后,APP 不出现在最近任务里,可减少被误清理的几率。
控制服务连接状态通知的显示与声音,默认「限断」:
设置收到消息时 TTS 语音播报的内容,默认播报「标题」。
设置重复提醒的时间间隔,默认 30 秒。开启后,未处理的消息会按此间隔反复提醒,避免漏看。
设置消息通知上是否显示「已读」「删除」快捷操作按钮。默认显示,可在通知栏直接处理消息。
侧边栏 → 权限设置。由于各安卓系统杀后台严重,为保证 PushMe 24 小时在线接收消息,请给予 APP 最大权限。
授予闹钟(Alarm)权限,用于后台服务的定时重连,保证服务断开后能自动恢复。
允许 APP 开机自动启动,确保手机重启后服务能自动恢复。进入系统设置后确认开启即可。
将 APP 加入电池优化白名单(忽略优化),防止系统因省电策略杀掉后台服务。
授予通知权限,允许 APP 显示推送通知(Android 13+ 需手动授予)。
管理各通知通道的铃声、振动、语音等(Android 8+)。APP 默认包含以下通道:
[~通道名] 语法创建的通道每个通道可独立配置「语音通知」与「重复通知」开关。
部分手机需要在最近任务页面长按 PushMe 卡片进行「锁定」,防止被一键清理。
侧边栏 → 其他设置。
管理 APP 内保存的文件,可查看、上传、删除文件。
临时密钥用于临时推送场景,过期后会自动失效。需先获取 push_key 后,才能获取 temp_key。
显示当前数据消息的统计数量,点击可进入数据小屏页面。详见 数据小屏。
侧边栏 → 发送消息,可在 APP 内直接发送测试消息:
如使用自建服务,需先填写自建服务的接口地址。
支持 text、markdown、html、url 等类型,满足各种文本推送需求;另有系统其它应用发出的 notify(json字符串)和定时任务发出的 task(文本)
支持 data、markdata、note、chart、echarts、svg 格式
支持信息、成功、警告、失败四种主题,让消息一目了然
支持自定义通道,为不同通道设置不同的声音、震动、通知方式
支持消息标题和内容语音播报,支持消息循环重复通知
支持分组头像和 emoji 头像,消息分类更清晰
数据消息支持悬浮、贴边显示,支持常驻状态栏
支持插件开发,对收到的消息进行验签、解密、加工处理
消息标题支持特殊语法来提取元信息,可组合使用:
[i] 信息主题(白色)[s] 成功主题(绿色)[w] 警告主题(黄色)[f] 失败主题(红色)格式:[~通道名],例如 [~重点通知]服务器告警。不同通道可在系统通知设置中配置不同的声音、震动。
[#PushMe]hello,头像取分组首字[#PushMe!😄]hello[#PushMe!https://xxx.jpg]hello[s][~我的通道][#张三!https://xxx.jpg] 任务完成
点击主页右下角圆形按钮进入数据小屏页面,展示 data、markdata、note、chart、echarts、svg 类型的数据消息。
数据类型消息(data、chart 等)可以以悬浮窗形式常驻显示在屏幕上:
点击主页右上角搜索图标,可搜索消息标题和内容:
侧边栏 → 关于我们。
跳转到反馈页面,可提交使用中遇到的问题或建议。
查看 PushMe 的版本更新记录,对应官网 更新日志 页面。
显示当前 APP 版本号,点击可检查是否有新版本。
push_key 是你在 PushMe APP 上获取的唯一标识,用于接收消息。相当于你的收件地址,别人通过这个 key 就能给你推送消息。
PushMe 接口兼容企业微信 / 钉钉 / 飞书群机器人的 webhook 格式,直接替换 webhook 地址为 PushMe 接口即可,参数无需改动。
APP 使用 AlarmManager 定时重连,间隔会逐渐增大(10~60 秒起步,每次增加 60 秒)。确保 APP 未被系统杀掉(开启自启动、忽略电池优化)。网络切换(WiFi / 移动数据)时会自动重连。
msg 对象