微信电话（探鸽平台）¶
介绍¶
基于探鸽(Tange)云平台，实现硬件设备与微信小程序之间的双向语音/视频通话，同时支持设备间P2P通话和AI对话功能。设备通过4G网络连接探鸽云平台，用户可通过微信小程序远程与设备进行实时通话。
环境准备¶
硬件清单¶
开发板（W09_EVB_V2.0）、喇叭、屏幕、天线、SIM、USB线
软件环境¶
- yopen源码SDK库（YOPEN SDK链接）
- 编译工具链（参考开发入门）
探鸽平台账号¶
参考探鸽平台账号注册指南注册账号，获取设备ID\Key（设备授权License）、小程序用户ID、APP ID、账户名/密码等配置信息。
编译步骤¶
配置平台参数¶
将探鸽提供的配置信息填入 app/tgai/src/tgai_cfg_dummy.h 文件：
// 设备授权License（设备ID,设备Key）
#define DEV_LIC_UUID "你的设备ID,你的设备Key"
// 小程序用户ID
#define DEV_OPEN_ID "你的小程序用户ID"
// 探鸽APP ID
#define TGAI_APPID_STRING "你的APPID"
// 探鸽账户
#define TGAI_ACCOUNT_NAME "你的用户名"
#define TGAI_ACCOUNT_PASSWORD "你的密码"
执行编译¶
.\build.bat YM310_W09S.C60 tgai
编译完成后，固件输出在工程目录下：
* GUI模式：YM310_OPEN.TGAI_GUI_R1.0.0_<时间戳>.bin
* Voice模式：YM310_OPEN.TGAI_VOICE_R1.0.0_<时间戳>.bin
如需切换为纯语音模式或启用视频通话，可编辑
project/tgai.cmake中的对应开关：
选项 说明 CONFIG_APP_TGAI_GUI_SUPPORT TRUE=GUI模式（默认），FALSE=纯语音模式，不带UI界面
操作说明¶
按键操作¶
| 按键 | 操作 | 功能 |
|---|---|---|
| Boot键 | 来电时短按 | 接听来电 |
| Boot键 | 空闲时短按 | 拨号（呼叫默认微信联系人） |
| Boot键 | 长按（>1.5s） | 切换到AI聊天界面 |
| Power键 | 短按 | 通话中挂断 / 空闲待机 |
| Power键 | 长按（>2s） | 关机 |
使用流程¶
1. 设备开机
设备开机后自动连接4G网络，注册到探鸽云平台。如设备已经绑定过小程序，连接成功后进入待机状态。如未绑定，需要先绑定小程序才能使用。
2. 绑定小程序
微信小程序搜索“tange演示“，打开小程序，按照【探鸽平台账号注册指南】进行注册登录后，扫描屏幕上的二维码进行设备绑定。
3. 授权通话
在微信小程序中，点击“授权通话”按钮，授权设备与微信小程序进行通话。
4. 微信来电
微信小程序用户发起呼叫 → 设备响铃 → 按Boot键接听 → 开始双向通话 → 按Power键挂断
5. 设备拨号
按Boot键 → 设备自动呼叫默认微信联系人 → 对方接听后开始通话 → 按Power键挂断
6. AI对话
长按Boot键进入AI模式 → 与AI进行语音对话 → 支持语音打断
源码介绍¶
目录结构¶
应用层 (app/tgai/)
| 源码 | 功能说明 |
|---|---|
| tgai_main.c | 主入口：硬件初始化、按键注册、启动任务 |
| tgai_gui.c | GUI模式：LVGL显示、通话/AI控制逻辑 |
| tgai_voice.c | 纯语音模式：按键通话 + TTS播报 |
组件层 (components/tgai/)
| 源码 | 功能说明 |
|---|---|
| tgai_service.c | 核心服务：状态机、P2P命令、AI RTC控制 |
| tgai_audio.c | 音频处理：AMR-WB录音/播放、铃声管理 |
| tgai_call_tci.c | 纯语音通话实现 |
| tgai_call_vdp.c | 视频通话实现（设备间P2P） |
探鸽云SDK头文件 (components/tgai/include/)
| 头文件 | 功能说明 |
|---|---|
| TgCloudApi.h | 探鸽云核心API |
| TgAiRtc.h | AI RTC接口 |
| wx.h | 微信VoIP接口 |
| vdp.h | 设备间P2P呼叫接口 |
编译选项说明¶
project/tgai.cmake 中的关键配置：
| 选项 | 说明 |
|---|---|
| CONFIG_APP_TGAI_GUI_SUPPORT | TRUE=GUI模式，FALSE=纯语音模式 |
| CONFIG_TGAI_VIDEO_ENABLE | 启用视频通话功能【视频帧率较低，还在优化中】 |
| LVGL_JD9853_ENABLE | LCD驱动选择（JD9853或ST7789） |
通信原理¶
音频格式¶
- 编码格式：AMR-WB
- 采样率：16kHz，16bit，单声道
- 全双工模式：同时录音和播放
通话类型¶
| 类型 | 说明 |
|---|---|
| 微信VoIP通话 | 微信小程序 ↔ 设备双向语音 |
| 设备间P2P通话 | 设备 ↔ 设备，支持音视频 |
| AI对话 | 设备 ↔ 云端AI，支持字幕和打断 |
通信流程¶
设备上电 → 4G网络注册 → SDK初始化 → 连接探鸽云平台 → 设备绑定成功 → 待机
微信来电：
平台推送来电 → 设备响铃 → 按键接听 → 双向语音通话 → 挂断
设备拨号：
按键拨号 → 呼叫微信用户 → 对方接听 → 双向语音通话 → 挂断