此项目暂未在产品展厅公开展示,你正在通过直链访问。在 管理看板勾选「在产品展厅展示」即可公开。
悦
开发成果 7/12
- 双端通话打通(电视 ↔ 手机,1001/1002)
- 手机端电视画面横屏 + 真圆角(TextureView)
- 来电三档:静默接通 / 3 秒自动接 / 一直响,设置可关
- 退后台挂断并真正释放麦克风(方案 A)
- 语音技能「给飞哥打个电话」+ Deep link 调起
- token 服务端现签,失败回退内置 token
- 微信式来电通知:通知栏 + 点接听直通通话
- 后台保活:前台服务 + 电池白名单,退后台仍能收到 INV
- 桌面/锁屏全屏来电自动弹出(绕开 MIUI 拦截)
- 反向拨号(电视打手机)接听链路补测
- 声网离线推送 + 厂商通道(进程被杀也能收到)
- token 服务上公网 + 设备档案后端下发
项目简介
基于声网 Agora RTC 的双端可视通话 App。手机端(小米 2509FPN0BC,uid=1002)与电视端(TCL tcl_mt5879_cn,uid=1001)同频道互呼,自绘深色 UI(无 AndroidX,裸 aapt2 + d8 + apksigner 构建,不走 Gradle)。已接入:来电三档(静默接通 / 3 秒自动接 / 一直响,设置可关)、退后台自动挂断并释放麦克风、语音技能与 Deep link 调起、服务端现签 token、微信式来电通知与点接听直通。
开发历程 6 条
代码上 Gitee:yueju-call 与 yueju-token-server 两个私有仓库
- 两个私有仓库已建并推送成功(Gitee API 建库 + SSH 推送,均 main 分支):
gitee.com/halley2026/yueju-call→5b1ddf1(10 文件 / 4097 行)gitee.com/halley2026/yueju-token-server→0adebe7(5 文件)- 推送前做了敏感文件体检:远端树里无
tokens//*.keystore/*.apk/.env,gen_token.sh也无硬编码证书,凭据全靠(本机路径)与.env.runtime现场读。 - 本机已有 Gitee 认证:SSH key
(本机路径)已绑 halley2026;另存有 HTTPS 令牌(可用于 API 建库 / 改仓库设置)。 - 约定:新项目默认私有仓库 + main 分支,远程用 SSH。
微信式全屏来电:通知层已通,卡在后台通道与 uid 级权限
- 需求:手机锁屏/在桌面时,来电能不能像微信一样整屏弹出来、直接接听?
- 第一层(通知写法)早就有了:
yueju_incoming_call渠道mImportance=4(HIGH),全屏 Intent + 响铃 + 震动 + 接听/拒接两个按钮,写法上和微信没差别。 - 第二层(系统权限)是卡点:Android 14+ 的
USE_FULL_SCREEN_INTENT有 uid 级 / package 级两套,之前只给了 package,uid 级是ignore→ 系统直接把fullScreenIntent摘掉,降级成普通通知。cmd appops set --uid ... allow后变allow。 - 第三层(来电根本到不了)才是真卡点:手机退到桌面后约 12 秒频道断(
信号通道异常 error=117),主叫再呼连INV都收不到。通知写得再对,没有来电事件就不会弹。 - 已验证:通知栏显示「客厅电视 / 邀请你视频通话」+ 两个 action;点「接听」不用先开 App 直接进通话(
通知动作 accept state=2→ 电视signal ACC)。 - 未验证:桌面/锁屏自动全屏弹出(副屏状态下 adb 截图取不到画面)。
- 结论:微信能弹靠的是厂商推送通道 + 悬浮窗白名单 + 通话类应用分类,不是通知 API 写法差异。缺的是 通知到达的通道。
「AppID 无效」是假象:109 其实是 token 过期,且有过 24 小时首次使用窗口
- 现象:语音可以跳转,但入会失败,界面上写「AppID 无效」。参数一字未改,两端同时挂。
- 真因:声网返回的是
109,含义是 Token 已过期;我们自己的errHint()把 109 写成了「AppID 无效」,把排查带偏了。官方对照:101 = AppID 无效,109 = Token 过期,110 = Token 无效(与频道 / uid 不匹配)。 - 更关键的冷知识:烤进 APK 的 token 有 24 小时首次使用窗口——生成后 24 小时内没被任何设备用过就作废,与
gen_token.sh里设的 7 天expire是两件事。所以「装完放两天的设备一开就挂」是必然。 - 修:错误文案按官方重写;token 改服务端现签。
- 同时发现
channel字段不复位:传过一次 channel 后不传仍沿用旧频道,INV发出去rc=-2,对端永远收不到 → 改成没带 channel 就回默认频道,实测错频道失败后紧接着调起能 381ms 入会。
语音技能「给飞哥打个电话」接通,token 改为服务端现签
- 语音技能:在
YuejuCallLauncher加aliases(飞哥 / 韩飞 / 老韩 / 飞)+ 倒装 / 「拨个电话」/ 尾部语气词剥离,JVM 跑 14 句回归:11 命中、3 句按预期落空走 TTS 兜底。 - 实测:
dialMs=3000→ 3002ms 接通,2500→ 2511ms;手机标题「客厅电视」;挂断后jumpBack ok回悦居智能首页。 - Deep link:
yuejucall://call?peer=1002&name=韩飞&ms=3000中文与毫秒均正确解码。 - token 服务:
outputs/token-server(Node + agora-token,:8788,POST /rtc/token,X-Api-Key 鉴权)。客户端入会前现取,超时 1800ms 自动回退内置 token,服务挂掉入会仍成功(557ms)。
- 语音技能:在
来电自动接听三档落地,设置页可关
- 需求:家人内部通话,允许 3 秒无人操作自动接听,设置里可以关。
- 三档:静默接通(INV 第 4 段=1 或调用方
autoAccept)/ 自动接听(默认autoAnswerMs=3000,响铃 + 接听·拒接 + 倒计时)/ 关闭(一直响,45 秒超时)。SharedPreferences("yueju_call")存auto_answer_ms。 - 入口:手机右上角「设置」+ 电视通讯录下方设置卡,自绘 Toggle(不用系统 Switch)。
- 三个坑:①
Toggle.setOn里if (on == v) return导致anim未同步,首次进设置页画成“关”;② 内部类不能声明成员接口(JLS 8.1.3),ToggleChange提到类级;③ 电视设置页按返回误弹“结束通话”确认 →onBackPressed先判page == PAGE_SETTINGS。 - 真机:手机
INV→ACC3010ms;电视来电同样 3 秒;关闭后响 6 秒仍停在来电页,手动接听正常。
电视画面横屏 + 真圆角:SurfaceView 换成 TextureView
- 问题:手机上电视画面加圆角后四个角是黑的,其实是 UI 坑。
- 根因:
SurfaceView的像素在独立 surface 图层,父容器的cornerRadius/clipChildren/setClipToOutline全部无效;之前用CornerMask涂 90% 近黑伪装圆角,一遇亮画面就成四个黑块。实测角落(21,25,33)vs 背景(51,57,64)。 - 修:手机端改
TextureView+setOutlineProvider(RoundRect)+setClipToOutline(true)真镂空,修后(54,60,66)vs(55,61,68)。电视端保持SurfaceView(零拷页、底色纯黑看不出)。 - 附带:电视编码 1280x720 +
RENDER_MODE_HIDDEN,塞进 358x392 卡片会裁掉左右 49%(只剩中间 51%)→ 卡片改 358x202,不裁不留黑边。 - 新坑:
getSurfaceTexture()是异步的,未就绪就setupRemoteVideo,SDK 不报错也不出画(现象等同“远端没推流”)→ 加ready()判断 +pendingRemoteUid记账补绑。
周期
2026-10-28 → 未定