Android平台RTSP|RTMP播放器(SmartPlayer)集成必读

技术背景

好多开发者拿到大牛直播SDK的Android平台RTSP、RTMP播放模块，基本上不看说明，测试后，就直接集成到自己系统了。不得不说，我们的模块虽然接口很多，功能支持全面，但是上层的demo设计逻辑确实简单，稍微有些Android开发基础的，都可以轻松处理。

从高效率的角度，磨刀不误砍柴工，在模块集成之前，还是希望开发者能了解播放器集成的一些前置条件，少走弯路，尽快完成RTSP、RTMP低延迟播放能力构建。

本文不关注接口集成调用细节，主要介绍下，播放器集成的一些前置条件和注意事项。

环境要求

前提条件

• 官方测试版：如需在测试阶段，做系统集成验证，可使用官方测试APP名称，不然会提示license验证失败，无法正常使用；
• 授权版：已拿到授权license key和授权库，使用授权的APP名称。

如需修改app-name，strings.xml修改即可：

<string name="app_name">SmartPlayerSDKDemo</string>

SmartPlayer目录

准备工作

• 确保SmartPlayerJniV2.java放到com.daniulive.smartplayer包名下(可在其他包名下调用)；
• Smartavengine.jar加入到工程；
• 拷贝SmartPlayerV2\app\src\main\jniLibs\armeabi-v7a、 SmartPlayerV2\app\src\main\jniLibs\arm64-v8a、SmartPlayerV2\app\src\main\jniLibs\x86和SmartPlayerV2\app\src\main\jniLibs\x86_64 下 libSmartPlayer.so到工程；
• AndroidManifast.xml添加相关权限：

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" >
</uses-permission>
<uses-permission android:name="android.permission.INTERNET" >
</uses-permission>
<uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />

• Load相关so：

static {  
    System.loadLibrary("SmartPlayer");
}

• build.gradle配置32/64位库：

splits {
    abi {
        enable true
        reset()
        // Specifies a list of ABIs that Gradle should create APKs for
        include 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64' //select ABIs to build APKs for
        // Specify that we do not want to also generate a universal APK that includes all ABIs
        universalApk true
    }
}

接口设计

功能支持

• 音频：AAC/Speex(RTMP)/PCMA/PCMU；
• 视频：H.264、H.265；
• 播放协议：RTSP|RTMP；
• 支持纯音频、纯视频、音视频播放；
• 支持多实例播放；
• 支持软解码，特定机型硬解码；
• 支持RTSP TCP、UDP模式设置；
• 支持RTSP TCP、UDP模式自动切换；
• 支持RTSP超时时间设置，单位：秒；
• 支持buffer时间设置，单位：毫秒；
• 支持超低延迟模式；
• 支持断网自动重连、视频追赶，支持buffer状态等回调；
• 支持视频view实时旋转（0° 90° 180° 270°）；
• 支持视频view水平反转、垂直反转；
• 支持Surfaceview/OpenGL ES/TextureView绘制；
• 支持视频画面填充模式设置；
• 音频支持AudioTrack、OpenSL ES模式；
• 支持jpeg、png实时截图；
• 支持实时音量调节；
• 支持解码前音视频数据回调；
• 支持解码后YUV/RGB数据回调；
• 支持Enhanced RTMP；
• 支持扩展录像功能；
• 支持Android 5.1及以上版本。