Android WebRTC 软件编解码基于 openH264 和 FFMpeg,但是编译时默认是不开启的,想要开启需要对代码做一定的增加修改,下面我将所有修改步骤一一列出。
本文基于
webRTC 版本:(https://chromium.googlesource.com/external/webrtc/+/branch-heads/4515)
设备:Mac
虚拟机:Parallels Desktop + Ubuntu 18.4
开始
一:修改 rtc_use_h264 返回值
路径:webrtc/src/webrtc.gni ,打开该文件,修改 rtc_use_h264 属性为 rtc_use_h264 = true
# rtc_use_h264 =
# proprietary_codecs && !is_android && !is_ios && !(is_win && !is_clang)
rtc_use_h264 = true
复制代码
二:修改 ffmpeg 相关编译参数
路径:webrtc/src/third_party/ffmpeg/ffmpeg_generated.gni
这里需要打开很多与 H264 相关的编译开关,务必看清楚,不然编译会报这种错❌
以下是我参考网上各种资料博客整理出来的,只编译 armv7、arm64
#:行
198#
if ((is_mac) || (is_win) || (use_linux_config))
修改
if ((is_mac) || (is_win) || (use_linux_config) || (is_android))
复制代码
252#
if ((is_mac && ffmpeg_branding == "Chrome") || (is_win && ffmpeg_branding == "Chrome") || (use_linux_config && ffmpeg_branding == "Chrome") || (use_linux_config && ffmpeg_branding == "ChromeOS"))
修改
if ((is_mac && ffmpeg_branding == "Chrome") || (is_win && ffmpeg_branding == "Chrome") || (use_linux_config && ffmpeg_branding == "Chrome") || (use_linux_config && ffmpeg_branding == "ChromeOS") || (is_android))
复制代码
295#
if ((is_mac && current_cpu == "x64") || (is_win && current_cpu == "x64") || (is_win && current_cpu == "x86") || (use_linux_config && current_cpu == "x64") || (use_linux_config && current_cpu == "x86"))
修改
if ((is_mac && current_cpu == "x64") || (is_win && current_cpu == "x64") || (is_win && current_cpu == "x86") || (use_linux_config && current_cpu == "x64") || (use_linux_config && current_cpu == "x86") || (is_android && current_cpu=="x86") || (is_android && current_cpu=="x64"))
复制代码
376#
if ((is_mac && current_cpu == "x64" && ffmpeg_branding == "Chrome") || (is_win && current_cpu == "x64" && ffmpeg_branding == "Chrome") || (is_win && current_cpu == "x86" && ffmpeg_branding == "Chrome") || (use_linux_config && current_cpu == "x64" && ffmpeg_branding == "Chrome") || (use_linux_config && current_cpu == "x64" && ffmpeg_branding == "ChromeOS") || (use_linux_config && current_cpu == "x86" && ffmpeg_branding == "Chrome") || (use_linux_config && current_cpu == "x86" && ffmpeg_branding == "ChromeOS"))
修改
if ((is_mac && current_cpu == "x64" && ffmpeg_branding == "Chrome") || (is_win && current_cpu == "x64" && ffmpeg_branding == "Chrome") || (is_win && current_cpu == "x86" && ffmpeg_branding == "Chrome") || (use_linux_config && current_cpu == "x64" && ffmpeg_branding == "Chrome") || (use_linux_config && current_cpu == "x64" && ffmpeg_branding == "ChromeOS") || (use_linux_config && current_cpu == "x86" && ffmpeg_branding == "Chrome") || (use_linux_config && current_cpu == "x86" && ffmpeg_branding == "ChromeOS") || (is_android && current_cpu == "x64"))
复制代码
397#
if ((is_mac && current_cpu == "arm64") || (is_win && current_cpu == "arm64") || (use_linux_config && current_cpu == "arm64"))
修改
if ((is_mac && current_cpu == "arm64") || (is_win && current_cpu == "arm64") || (use_linux_config && current_cpu == "arm64") || (is_android && current_cpu == "arm64"))
复制代码
423#
if ((is_mac && current_cpu == "arm64" && ffmpeg_branding == "Chrome") || (is_win && current_cpu == "arm64" && ffmpeg_branding == "Chrome") || (use_linux_config && current_cpu == "arm64" && ffmpeg_branding == "Chrome") || (use_linux_config && current_cpu == "arm64" && ffmpeg_branding == "ChromeOS")
修改
if ((is_mac && current_cpu == "arm64" && ffmpeg_branding == "Chrome") || (is_win && current_cpu == "arm64" && ffmpeg_branding == "Chrome") || (use_linux_config && current_cpu == "arm64" && ffmpeg_branding == "Chrome") || (use_linux_config && current_cpu == "arm64" && ffmpeg_branding == "ChromeOS") || (is_android && current_cpu == "arm64"))
复制代码
487#
if ((use_linux_config && current_cpu == "arm" && arm_use_neon) || (use_linux_config && current_cpu == "arm"))
修改
if ((use_linux_config && current_cpu == "arm" && arm_use_neon) || (use_linux_config && current_cpu == "arm") || (is_android && current_cpu == "arm"))
复制代码
527#
if ((use_linux_config && current_cpu == "arm" && arm_use_neon && ffmpeg_branding == "Chrome") || (use_linux_config && current_cpu == "arm" && arm_use_neon && ffmpeg_branding == "ChromeOS") || (use_linux_config && current_cpu == "arm" && ffmpeg_branding == "Chrome") || (use_linux_config && current_cpu == "arm" && ffmpeg_branding == "ChromeOS"))修改if ((use_linux_config && current_cpu == "arm" && arm_use_neon && ffmpeg_branding == "Chrome") || (use_linux_config && current_cpu == "arm" && arm_use_neon && ffmpeg_branding == "ChromeOS") || (use_linux_config && current_cpu == "arm" && ffmpeg_branding == "Chrome") || (use_linux_config && current_cpu == "arm" && ffmpeg_branding == "ChromeOS")|| (is_android && current_cpu == "arm" && arm_use_neon))
复制代码
545#
if (use_linux_config && current_cpu == "arm" && arm_use_neon)修改if (use_linux_config && current_cpu == "arm" && arm_use_neon || (is_android && current_cpu == "arm" && arm_use_neon))
复制代码
564#
if ((use_linux_config && current_cpu == "arm" && arm_use_neon && ffmpeg_branding == "Chrome") || (use_linux_config && current_cpu == "arm" && arm_use_neon && ffmpeg_branding == "ChromeOS"))修改if ((use_linux_config && current_cpu == "arm" && arm_use_neon && ffmpeg_branding == "Chrome") || (use_linux_config && current_cpu == "arm" && arm_use_neon && ffmpeg_branding == "ChromeOS")||(is_android && current_cpu =="arm" && arm_use_neon))
复制代码
三:添加静态编译
路径 1:webrtc_source/webrtc/src/third_party/ffmpeg/chromium/config/Chromium/android/<ABI>/libavcodec/codec_list.c
添加 &ff_h264_decoder
static const AVCodec * const codec_list[] = { &ff_flac_decoder, &ff_mp3_decoder, &ff_vorbis_decoder, &ff_pcm_alaw_decoder, &ff_pcm_f32le_decoder, &ff_pcm_mulaw_decoder, &ff_pcm_s16be_decoder, &ff_pcm_s16le_decoder, &ff_pcm_s24be_decoder, &ff_pcm_s24le_decoder, &ff_pcm_s32le_decoder, &ff_pcm_u8_decoder, &ff_libopus_decoder, &ff_h264_decoder, NULL };
复制代码
路径 2:webrtc_source/webrtc/src/third_party/ffmpeg/chromium/config/Chromium/android/<ABI>/libavcodec/parser_list.c
添加 &ff_h264_parser
static const AVCodecParser * const parser_list[] = { &ff_flac_parser, &ff_mpegaudio_parser, &ff_opus_parser, &ff_vorbis_parser, &ff_vp9_parser, &ff_h264_parser, NULL };
复制代码
四:修改宏定义
路径:webrtc/src/third_party/ffmpeg/chromium/config/Chromium/android/<ABI>/config.h
搜索 CONFIG_H264_DECODER 将其值由 0 改为 1
#define CONFIG_H264_DECODER 1
复制代码
五:添加 Licenses
路径:webrtc/src/tools_webrtc/libs/generate_licenses.py
找到 LIB_TO_LICENSES_DICT 在节点中添加
LIB_TO_LICENSES_DICT = { 'abseil-cpp': ['third_party/abseil-cpp/LICENSE'], ... 'spl_sqrt_floor': ['common_audio/third_party/spl_sqrt_floor/LICENSE'], 'openh264':['third_party/openh264/src/LICENSE'],#添加 'ffmpeg':['third_party/ffmpeg/LICENSE.md']#添加}
复制代码
六:创建 h264_codec.cc
路径:webrtc/src/sdk/android/src/jni/
在上述路径新建一个文件 h264_codec.cc
#include <jni.h>#include "modules/video_coding/codecs/h264/include/h264.h"#include "sdk/android/generated_h264_jni/H264Decoder_jni.h"#include "sdk/android/generated_h264_jni/H264Encoder_jni.h"#include "sdk/android/src/jni/jni_helpers.h"namespace webrtc {namespace jni {static jlong JNI_H264Encoder_CreateEncoder(JNIEnv* jni) { return jlongFromPointer(H264Encoder::Create(cricket::VideoCodec(cricket::kH264CodecName)).release());}static jboolean JNI_H264Encoder_IsSupported(JNIEnv* jni) {return !SupportedH264Codecs().empty();}static jlong JNI_H264Decoder_CreateDecoder(JNIEnv* jni) { return jlongFromPointer(H264Decoder::Create().release());}static jboolean JNI_H264Decoder_IsSupported(JNIEnv* jni) {return !SupportedH264Codecs().empty();}} // namespace jni} // namespace webrtc
复制代码
七:创建 H264Encode.java 和 H264Decoder.java
路径:webrtc/src/sdk/android/src/java/org/webrtc/
如果是要编译成 aar,则在上述目录增加 2 个 java 文件。如果是做 NDK 开发自己要修改 webrtc 代码,上述文件可以放在你自己的 sdk 中,保证目录是 org/webrtc/即可。
H264Decoder.java
package org.webrtc;public class H264Decoder extends WrappedNativeVideoDecoder { @Override public long createNativeVideoDecoder() { return nativeCreateDecoder(); } static native boolean nativeIsSupported(); static native long nativeCreateDecoder();}
复制代码
H264Encoder.java
package org.webrtc;public class H264Encoder extends WrappedNativeVideoEncoder { @Override public long createNativeVideoEncoder() { return nativeCreateEncoder(); } static native long nativeCreateEncoder(); @Override public boolean isHardwareEncoder() { return false; } static native boolean nativeIsSupported();}
复制代码
八:修改 java 层软件编解码类
找到 SoftwareVideoEncoderFactory.java
public VideoEncoder createEncoder(VideoCodecInfo codecInfo) { String codecName = codecInfo.getName(); if (codecName.equalsIgnoreCase("H264")) {//新增 return new H264Encoder();//新增 }//新增
复制代码
找到 SoftwareVideoDecoderFactory.java
public VideoDecoder createDecoder(VideoCodecInfo codecInfo) { String codecName = codecInfo.getName(); if (codecName.equalsIgnoreCase(VideoCodecMimeType.H264.toSdpCodecName())){//新增 return new H264Decoder();//新增 }//新增
复制代码
九:添加 H264 编译脚本
模仿其他编解码器写
路径:webrtc/src/sdk/android/BUILD.gn
51#
增加:":h264_java",
505#
增加
rtc_android_library("h264_java") { visibility = [ "*" ] sources = [ "api/org/webrtc/H264Decoder.java", "api/org/webrtc/H264Encoder.java", ] deps = [ ":base_java", ":video_api_java", ":video_java", "//rtc_base:base_java", ] }
复制代码
545#
增加:":h264_java",
860#
增加:
rtc_library("h264_jni") { visibility = [ "*" ] allow_poison = [ "software_video_codecs" ] sources = [ "src/jni/h264_codec.cc" ] deps = [ ":base_jni", ":generated_h264_jni", ":video_jni", "../../modules/video_coding:webrtc_h264", ] }
复制代码
895#
增加: ":h264_jni",
1329#
增加:
generate_jni("generated_h264_jni") { sources = [ "api/org/webrtc/H264Decoder.java", "api/org/webrtc/H264Encoder.java", ] namespace = "webrtc::jni" jni_generator_include = "//sdk/android/src/jni/jni_generator_helper.h" }
复制代码
十:编译
gn gen out/m93 --args='is_debug=false target_os="android" target_cpu="arm64" rtc_use_h264=true use_custom_libcxx=false'
复制代码
ninja -C out/release/arm64-v8a
复制代码
ffmpeg 冲突
这样编译出来的静态库就包含了 ffmpeg,但是是残缺版的 ffmpeg,功能很少。如果自己项目中也有需要用到 ffmpeg 的地方就很难共用 webrtc 中的。自己集成的话会报重复定义的冲突。
网上这方面的解决办法比较少,后来经过几天的搜索,偶然发现编译命令有个选项:is_component_ffmpeg 设置为 false 的话就是使用动态库,这样的话自己再集成 ffmpeg,让 webRTC 使用你集成的,这样就不会有冲突了~
评论