如何在Android版Linphone中启用x264视频编解码器

结合你遇到的Android端Linphone启用x264的问题，我整理了几个关键排查和解决步骤，帮你搞定黑屏问题：

你当前的编译参数同时开启了ENABLE_OPENH264=ON和ENABLE_X264=ON，这两个都是H.264实现，Linphone大概率会优先选择openh264，导致x264没真正生效。另外x264属于GPL协议的第三方库，ENABLE_GPL_THIRD_PARTIES必须设为YES才能编译它，建议修改参数为：

./prepare.py -DENABLE_GPL_THIRD_PARTIES=YES -DENABLE_NON_FREE_CODECS=ON -DENABLE_VPX=NO -DENABLE_VCARD=NO -DENABLE_DOC=NO -DENABLE_OPENH264=OFF -DENABLE_X264=ON

执行后重新编译，确保过程中没有x264相关的编译错误。

编译完成后，去Android项目的libs目录下，检查各个ABI文件夹（比如arm64-v8a、armeabi-v7a）里是否存在libx264.so文件。如果没有，说明x264没被编译进Linphone：

• 可以手动单独编译x264源码，把生成的so文件放到对应ABI目录
• 或者检查prepare.py执行时的日志，确认x264源码是否被正常拉取和编译

就算编译了x264，Linphone默认可能不会优先选用它，需要手动配置优先级：

1. 代码层面设置：在初始化LinphoneCore的逻辑里，调整编解码器优先级：

LinphoneCore linphoneCore = LinphoneCoreFactory.instance().createLinphoneCore(...);
VideoCodec[] videoCodecs = linphoneCore.getVideoCodecs();
for (VideoCodec codec : videoCodecs) {
    if (codec.getMime().equals("H264") && codec.getDescription().contains("x264")) {
        codec.setPriority(255); // 设置最高优先级
    } else if (codec.getMime().equals("H264") && codec.getDescription().contains("openh264")) {
        codec.setPriority(0); // 禁用openh264
    }
}

2. 配置文件修改：找到项目中的linphonerc配置文件，添加或更新视频编解码器优先级：

[video_codec]
h264/x264=255
h264/openh264=0

启动应用后，过滤日志关键词，确认x264是否被成功加载：

• 搜索Loaded video codec: H264 (x264)
• 或者Using video codec: H264/x264
  如果日志里完全没出现x264相关内容，说明编译或配置环节还有问题，得重新查看编译日志找错误点。

要是x264已经正常加载但还是黑屏，再检查这几点：

• 设备硬件是否支持x264编码/解码（大部分现代Android设备没问题，但低端设备可能存在兼容性问题）
• 网络带宽是否足够，有没有持续丢包（可以用Linphone内置的网络诊断工具测试）
• 摄像头权限是否授予，应用能否正常预览摄像头画面

内容的提问来源于stack exchange，提问作者James Chan