{"id":47291459,"url":"https://github.com/evan8686/eew-receiver","last_synced_at":"2026-04-07T20:02:10.512Z","repository":{"id":342357994,"uuid":"1173476798","full_name":"evan8686/EEW-Receiver","owner":"evan8686","description":"一个基于wolfx公开API推送服务的即时地震预警 Android APP","archived":false,"fork":false,"pushed_at":"2026-04-04T20:19:35.000Z","size":14597,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-04T21:53:15.910Z","etag":null,"topics":["android-app","earthquake","earthquake-detection","earthquake-early-warning","eew"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/evan8686.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-05T12:08:59.000Z","updated_at":"2026-04-04T20:19:40.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/evan8686/EEW-Receiver","commit_stats":null,"previous_names":["evan8686/eew-receiver"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/evan8686/EEW-Receiver","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evan8686%2FEEW-Receiver","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evan8686%2FEEW-Receiver/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evan8686%2FEEW-Receiver/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evan8686%2FEEW-Receiver/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/evan8686","download_url":"https://codeload.github.com/evan8686/EEW-Receiver/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evan8686%2FEEW-Receiver/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31526666,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-07T16:28:08.000Z","status":"ssl_error","status_checked_at":"2026-04-07T16:28:06.951Z","response_time":105,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android-app","earthquake","earthquake-detection","earthquake-early-warning","eew"],"created_at":"2026-03-16T08:12:39.069Z","updated_at":"2026-04-07T20:02:10.500Z","avatar_url":"https://github.com/evan8686.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"# EEW-Receiver (地震预警接收器)\n![EEW Receiver Banner](assets/mybanner.png)\n\n[![下载最新版本](https://img.shields.io/badge/下载-最新版本APK-success?style=for-the-badge\u0026logo=android)](https://github.com/evan8686/EEW-Receiver/releases/latest)\n\n### 📌 项目目的\n大陆的地震预警系统目前尚未接入 **台湾地区中央气象署（CWA）** 的地震预警。而作为受台湾地震影响明显的 福建/浙江 地区，经常有明显震感，却得不到任何预警。为了确保福建、浙江南部沿海城市的居民能及时收到预警，特别做了这个项目。\n\n### 🛠️ 项目性质\n* **开发背景**：本项目纯属个人在 **Gemini AI** 辅助下开发。\n* **技术架构**：使用了 **Wolfx** 的 websocket API 接口来订阅推送。API 说明：https://wolfx.jp/apidoc_zh\n* **注意事项**：本人不对接口的稳定性负责。本人暂无软件开发经验，目前项目以自用为主要目的。\n* **核心优势**：不使用Google FCM推送，而是直接接收来自websocket API的推送。确保第一时间收到推送！（您在谷歌应用商店安装的来自其他地区的预警APP，通常使用谷歌FCM推送，在大陆网络环境可能无法正常获取推送，延时可能长达数小时甚至一整天，这对于地震预警来说将失去意义）\n---\n\n### 📖 使用说明\n1. **修改阈值**：打开 APP 进入设置，可修改全屏警报的震级阈值（此处指的是EEW推送里的震级，而非您的本地实际震级。默认为3）。\n2. **权限授予**：确保您已经为 APP 授予了所有必要的通知权限，并在系统设置中配置防杀后台相关的权限。\n3. **运行状态**：\n    * **监控中**：未收到预警时，通知栏会常驻“地震预警监控中”的通知（为了防杀）。\n    * **未达阈值**：收到 API 的地震预警推送时，若未达阈值，将只弹普通通知。\n    * **达到阈值**：若已达阈值，则除了弹通知外，还将触发全屏警报、震动。\n4. **数据源说明**：当前内建默认源为 **台湾中央气象署**。（这是福建地区迫切需要的预警信息。您可自行勾选更多源，但这将增加耗电。大陆境内发生的地震预警，仍然建议您开启手机系统自带的地震预警）\n5. **强制警报**：为了不漏掉任何一次关键预警，APP 采用系统闹钟音量通道进行播报。警报音量将不受媒体音量静音或手机响铃模式影响，完全遵循您的系统闹钟音量设置，确保预警信息的第一时间送达。\n---\n\n### 🧪 功能测试流程【请务必在安装后进行测试！！！】\n\n#### 1. 测试手机使用状态下全屏弹窗警报功能\n* 点击设置页面中的 **“模拟触发”** 按钮。\n* 立即返回到手机桌面。\n* 等待全屏警报弹出，确认是否有全屏警报、声音和震动，并查看通知栏是否有测试预警的通知。\n\n#### 2. 测试锁屏息屏状态下全屏弹窗警报功能\n* 点击 **“模拟触发”** 按钮后，立即返回桌面并立刻按下电源键息屏（需在 3 秒内尽快完成）。\n* 等待全屏警报弹出，确认是否有全屏警报、声音和震动，并查看通知栏是否有测试预警的通知。\n\n---\n\n### ⚠️ 关键配置【重要！！！APP需要后台保活才有意义！】\n请严格按下列方式操作，以确保核心预警功能能够保活并持续工作：\n\n#### **1. 设置 - 通知 - EEW Receiver**\n* **a.** 开启“允许通知”，并将 **“锁屏/横幅”** 打勾。\n* **b.** 打开 **“铃声/震动/允许打扰”**（该项指即便手机处于免打扰模式时，应用仍能正常响铃和震动）。\n* **c.** 将“类别”下的 **“地震预警事件”** 设为允许通知，“地震预警后台监控”则维持默认的“静默通知”即可。\n\n#### **2. 设置 - 应用管理 - EEW Receiver - 权限管理**\n* **a.** 锁屏显示：设为 **“允许”**。\n* **b.** 滚动页面到下方，进入 **“其他权限”** -\u003e **“特殊应用权限”**：（您先进入这个页面，尝试调整权限，系统会提示您需要解锁限制）\n* **c.** 回到EEW Receiver - 权限管理 主界面，此时点击右上角新出现的 3 个点，选择 **“解锁所有授权限制”** 进行解除。\n* **d.** 回到**“特殊应用权限”**页面\n    * **悬浮窗**：设为“允许”。\n    * **后台弹出界面**：设为“允许”。\n    * **发送全屏通知**：设为“允许”。\n\n#### **3. 桌面多任务界面 - EEW Receiver - 锁定不清理**\n* **a.** 上滑呼出多任务界面\n* **b.** 找到 EEW Reveiver，点击 3 个点，选择 **“锁定”**  （即，在多任务窗口一键清理使用过的应用时，不会被杀掉）\n\n#### **4. 耗电管理 - EEW Receiver - 完全允许后台行为**\n* **a.** 进入耗电管理相关的设置界面\n* **b.** 找到 EEW Reveiver，选择 **“完全允许后台行为”**  \n\n#### **5. 应用 - 自启动 - 允许 EEW Receiver 自启动**\n\n#### 以上设置 以 OPPO ColorOS 16 为例，若您使用 小米澎湃OS，vivo OriginOS 等，请自行参考并在系统设置中操作相关选项\n#### 部分选项名称和入口在不同OS上可能略有差异，但基本类似。\n\n\n---\n\n### 🚧 待优化方向与注意事项\n欢迎各位大神针对以下方向进行优化：\n* [ ] **距离判断**：目前收到推送直接触发，不判断所在地与震中的距离。\n* [ ] **烈度测算**：目前无法进行震波到达倒计时及本地烈度测算。\n* [ ] **地图功能**：目前没有内置显示震中位置的地图功能。\n* [ ] ......\n\n---\n\n## 🙏 特别鸣谢\n\n本项目的数据源与灵感离不开以下开源项目与无私服务的支持：\n\n* **[Wolfx Project](https://wolfx.jp/)**：为本项目提供了稳定、快速且无私的地震预警 WebSocket API 转发服务。\n* **[kanameishi 要石](https://github.com/Lipomoea/kanameishi)**：为本项目的开发与数据源接入提供了优秀的参考与灵感。（要石 是一个电脑版的地震预警软件，非常推荐在电脑端安装）\n\n---\n\n## ⚠️ 免责声明\n\n1. **个人业余项目**：本项目为个人出于兴趣和防灾需求开发的非商业化测试软件。本人非专业安卓开发工程师，软件开发经验有限。应用在实际运行中可能存在 Bug 等问题，仅供**日常辅助参考与测试使用**，如有不完善之处请多海涵。\n2. **第三方服务稳定性**：本应用的数据强依赖于 [Wolfx Project] 提供的第三方 API 接口。对于因网络波动、您的本地网络环境、第三方接口异常等原因导致的预警延迟、断线或接收失败，开发者无法控制，亦无法提供任何全天候的稳定性保证。\n3. **预警准确性局限**：地震预警（EEW）是一项极其复杂的科学与工程系统。本应用展示的所有预警信息，均直接客观地转发自各地震监测发布机构（如中国地震台网、台湾地区中央气象署等）的原始测定报文。受限于现代地震台网的观测密度与科学算法的物理极限，**预警信息不可避免地会存在误差、误报、漏报或与最终测定结果不符的情况。**\n4. **软件后台运行稳定性**：尽管开发过程以尽量确保软件能在手机后台保活，并做出配置说明。由于各品牌手机OS处理应用后台进程的逻辑不同，因此无法保证在所有手机上都能持久后台保活。如遇到应用无法保活问题，请务必检查是否依照配置说明正确设置，或与您的手机品牌方联系了解或反馈应用后台保活问题。\n4. **免责条款**：请务必**不要**将本应用作为您生命和财产安全的唯一依赖手段。在收到预警警报时，请结合您身边的实际震感与环境迅速做出合理的避险判断。**对于使用或无法使用本软件而导致的任何直接或间接损失（包括但不限于人身伤害、财产损失、恐慌等），开发者不承担任何形式的法律与经济责任。** 使用本软件即代表您已知晓并同意本免责声明的全部内容。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevan8686%2Feew-receiver","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fevan8686%2Feew-receiver","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevan8686%2Feew-receiver/lists"}