使用VLCKit 3.3.17 pod时iPhone12系列不支持RTSP链接问题

报错核心信息：Unable to determine our source address: This computer has an invalid IP address: 0.0.0.0

问题根因 #

该报错触发在VLC底层RTSP传输协商阶段，iPhone12系列搭载的iOS14及以上系统对本地网络权限、网卡IP枚举逻辑做了调整，旧版MobileVLCKit的IP检测逻辑未做适配，无法读取设备有效本地IP，只能获取到0.0.0.0的无效地址导致协商失败。

排查步骤 #

• 检查本地网络权限配置
  确认项目Info.plist中已添加NSLocalNetworkUsageDescription权限声明，iPhone12系列起系统强制校验本地网络访问权限，未申请权限时APP无法读取网卡真实IP。
• 检查MobileVLCKit版本
  确认当前接入的库版本不低于3.3.17，低于该版本的MobileVLCKit未适配iPhone12系列的IP枚举逻辑，会跳过新机型虚拟网卡的解析流程，无法拿到有效IP。
• 检查RTSP传输参数配置
  确认初始化VLC时没有强制指定rtp-client-port=0，也没有未声明本地绑定端口范围，iPhone12系列网络栈要求显式指定合法端口范围，否则会默认绑定到0.0.0.0无效地址。

修复方案 #

• 方案1：升级依赖库
  直接将MobileVLCKit升级到3.3.17及以上稳定版本，该版本已官方适配iPhone12系列的IP检测逻辑，无需额外修改代码即可正常播放。
• 方案2：添加VLC启动参数适配
  如果暂时无法升级库版本，在初始化VLCMediaPlayer时传入以下启动参数：

// OC示例
NSArray *vlcOptions = @[@"--rtsp-client-port=6000-6100", @"--ifaddr=auto"];
VLCMediaPlayer *player = [[VLCMediaPlayer alloc] initWithOptions:vlcOptions];

// Swift示例
let vlcOptions = ["--rtsp-client-port=6000-6100", "--ifaddr=auto"]
let player = VLCMediaPlayer(options: vlcOptions)

参数作用为强制VLC自动选择有效网卡，绑定6000-6100区间的可用端口，避免绑定到0.0.0.0地址。

• 方案3：手动传入设备有效IP
  若上述方案均无效，可在初始化播放器前先获取设备当前WIFI/蜂窝网络的真实IP，传入ifaddr参数：
  --ifaddr=当前设备的真实IP地址

内容的提问来源于stack exchange，提问作者Manish Mishra