SipClient
SipClient 是一个基于 Android 平台的 SIP 客户端应用,主要用于实现 VoIP(语音和视频通话)功能,支持通过 SIP 协议进行通信。
Web版的可以参考: WebPhone
功能特性
- SIP 注册与注销:支持 SIP 账号的注册和注销功能
- 音频通话:支持发起和接听音频通话
- 通话管理:支持通话保持、取消保持、挂断等操作
- 拨号盘:直观的拨号界面,支持数字输入和删除功能
- 联系人管理:支持多账号管理和切换
- 状态显示:实时显示在线状态和通话状态
- 归属地显示:显示来电或去电的归属地信息
- 通话计时:实时显示通话时长
- 协议支持:支持 UDP、TCP、TLS 协议
技术架构
核心技术
- SIP 协议栈:基于 PJSIP 库实现
- Android 原生开发:使用 Java 语言开发
- Material Design:遵循 Material Design 设计规范
- 事件驱动:采用事件总线机制实现组件间通信
- 后台服务:使用 Foreground Service 确保服务持续运行
主要组件
- MainActivity:主界面,包含拨号盘和通话控制功能
- AccountEditActivity:账号编辑界面,用于添加和编辑 SIP 账号
- SipServiceManager:SIP 服务管理器,负责与后台服务通信
- SipBackgroundService:后台服务,处理 SIP 协议相关操作
- SipEventBus:事件总线,用于组件间通信
界面设计
主界面
主界面采用简洁直观的设计,包含以下主要区域:
- 顶部状态栏:显示用户头像、分机信息和在线状态
- 号码显示区域:显示当前输入的号码或通话中的号码
- 归属地显示:显示号码的归属地信息
- 通话计时:显示当前通话的时长
- 拨号键盘:包含数字按键和功能按键
- 通话控制按钮:包括呼叫/挂断按钮、保持按钮、拨号盘切换按钮
- 底部状态栏:显示版本信息
账号管理界面
账号管理界面支持添加和编辑 SIP 账号,包含以下字段:
- 分机名
- 分机号 *
- 密码 *
- 服务地址 *
- 域名 *
- 协议类型(UDP/TCP/TLS)
- 服务端口
- HA1 密码处理开关
系统要求
- 最低 Android 版本:Android 7.0 (API level 24)
- 目标 Android 版本:Android 14 (API level 34)
- 开发环境:
- JDK 1.8 或更高版本
- Android Studio
- Gradle 8.5 或更高版本
权限说明
应用需要以下权限来正常运行:
INTERNET
:网络访问权限ACCESS_NETWORK_STATE
:网络状态访问权限USE_SIP
:SIP 协议使用权限RECORD_AUDIO
:录音权限MODIFY_AUDIO_SETTINGS
:音频设置修改权限WAKE_LOCK
:唤醒锁权限FOREGROUND_SERVICE
:前台服务权限FOREGROUND_SERVICE_PHONE_CALL
:电话呼叫前台服务权限