iOS 16与Xcode 14环境下PJSIP VoIP Socket启动崩溃求助

问题根源 #

iOS 16起苹果彻底废弃了传统VoIP Socket的后台唤醒机制，链接iOS 16+ SDK的应用继续使用该机制会触发崩溃，官方强制要求改用Local Push Connectivity（LPC）实现VoIP后台唤醒与连接管理。

适配步骤 #

1. 项目配置调整 #

• 打开Xcode项目的Signing & Capabilities，添加Push Notifications能力
• 开启Background Modes，勾选Voice over IP和Remote notifications两项
• 将Deployment Target设为iOS 16.0及以上，确保使用iOS 16 SDK编译

2. 集成Local Push Connectivity（基于PushKit） #

替换原VoIP Socket逻辑，用PushKit实现唤醒触发：

import PushKit

class LPCClient: NSObject, PKPushRegistryDelegate {
    private var pushRegistry: PKPushRegistry!
    // 保存当前SIP账号ID，用于后续传递令牌
    private var sipAccountId: pjsua_acc_id = PJSUA_INVALID_ID
    
    func setupLPC(with accountId: pjsua_acc_id) {
        sipAccountId = accountId
        pushRegistry = PKPushRegistry(queue: DispatchQueue.global(qos: .background))
        pushRegistry.delegate = self
        pushRegistry.desiredPushTypes = [.voIP]
    }
    
    // 获取推送令牌，同步到SIP服务器
    func pushRegistry(_ registry: PKPushRegistry, didUpdate pushCredentials: PKPushCredentials, for type: PKPushType) {
        let token = pushCredentials.token.map { String(format: "%02hhx", $0) }.joined()
        // 调用PJSIP API将令牌绑定到对应账号
        pjsua_acc_set_push_token(sipAccountId, PJ_TRUE, token.utf8CString, nil)
    }
    
    // 收到VoIP推送，唤醒PJSIP连接并处理来电
    func pushRegistry(_ registry: PKPushRegistry, didReceiveIncomingPushWith payload: PKPushPayload, for type: PKPushType, completion: @escaping () -> Void) {
        // 解析推送payload中的SIP呼叫信息，触发PJSIP处理逻辑
        if let callData = payload.dictionaryPayload["call_data"] as? String {
            // 这里根据实际业务处理呼叫，比如触发PJSIP来电逻辑
            handleIncomingSIPCall(from: callData)
        }
        completion()
    }
    
    private func handleIncomingSIPCall(from callData: String) {
        // 重建PJSIP连接（如果已断开），处理来电
        pjsua_acc_set_online(sipAccountId, PJ_TRUE)
        // 具体呼叫处理逻辑根据你的PJSIP集成实现调整
    }
}

3. 修改PJSIP配置 #

禁用PJSIP自带的VoIP Socket相关配置，避免冲突：

pjsua_config cfg;
pjsua_config_default(&cfg);

// 关闭旧的后台唤醒逻辑
cfg.ua_config.no_sip_timer = PJ_TRUE;
// 禁用自动重连的长连接逻辑，改为推送唤醒后重建
cfg.reconfig_flag &= ~PJSUA_RECFG_ACC_AUTO_RECONNECT;

4. 后台连接管理逻辑 #

• 应用进入后台时，主动断开PJSIP长连接，减少资源占用：

  pjsua_acc_set_online(sipAccountId, PJ_FALSE);
  

• 收到VoIP推送后，立即重新上线PJSIP账号，建立连接处理请求

关键注意事项 #

• 必须使用真实iOS设备测试，模拟器不支持PushKit功能
• SIP服务器需适配APNs VoIP推送，能根据推送令牌向指定设备发送唤醒通知
• 确保VoIP推送证书配置正确，该证书与普通推送证书不通用，需单独申请

内容的提问来源于stack exchange，提问作者Yoni Reiss