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

技术背景

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

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

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

环境要求

类别	说明
系统版本	Android 5.1及以上版本。
手机芯片	架构要求： armv7 arm64 x86 x86_64
开发工具	推荐使用Android Studio，Android Studio下载地址：Android Studio。

前提条件

• 官方测试版：如需在测试阶段，做系统集成验证，可使用官方测试APP名称，不然会提示license验证失败，无法正常使用；

• 授权版：已拿到授权license key和授权库，使用授权的APP名称。

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

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

SmartPlayer目录

文件名	作用
SmartPlayerV2	RTSP|RTMP直播播放器Demo工程源码
SmartPlayerV2\app\src\main\jniLibs	smartavengine.jar和libSmartPlayer.so
SmartPlayerV2\app\src\main\java\com\daniulive\ smartplayer\SmartPlayerJniV2.java	播放器头文件
SmartPlayerV2\app\src\main\java\com\daniulive\ smartplayer\SmartPlayer.java	接口调用示例

准备工作

• 确保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
    }
}

接口设计

Android RTSP|RTMP播放端SDK接口详解
调用描述		接口	接口描述
最先调用，如成功返回播放实例		SmartPlayerOpen	player初始化，设置上下文信息，返回player句柄
Event回调		SetSmartPlayerEventCallbackV2	设置event callback
硬解码设置（H.264）		SetSmartPlayerVideoHWDecoder	设置是否用H.264硬解码播放，如硬解码不支持，自动适配到软解码
硬解码设置（H.265）		SetSmartPlayerVideoHevcHWDecoder	设置是否用H.265硬解码播放，如硬解码不支持，自动适配到软解码
视频画面 填充模式		SmartPlayerSetRenderScaleMode	设置视频画面的填充模式，如填充整个view、等比例填充view，如不设置，默认填充整个view
设置SurfaceView模式下render类型		SmartPlayerSetSurfaceRenderFormat	设置SurfaceView模式下(NTRenderer.CreateRenderer第二个参数传false的情况)，render类型 0: RGB565格式，如不设置，默认此模式; 1: ARGB8888格式
设置SurfaceView模式下抗锯齿效果		SmartPlayerSetSurfaceAntiAlias	设置SurfaceView模式下(NTRenderer.CreateRenderer第二个参数传false的情况)，抗锯齿效果，注意：抗锯齿模式开启后，可能会影像性能，请慎用
设置播放的surface		SmartPlayerSetSurface	设置播放的surface，如果为null，则播放纯音频
设置视频硬解码下Mediacodec自行绘制模式		SmartPlayerSetHWRenderMode	此种模式下，硬解码兼容性和效率更好，回调YUV/RGB、快照和图像等比例缩放功能将不可用
更新硬解码surface		SmartPlayerUpdateHWRenderSurface	设置更新硬解码surface
音频回调	YUV/RGB	SmartPlayerSetExternalRender	提供解码后YUV/RGB数据接口，供用户自己render或进一步处理(如视频分析)
	Audio	SmartPlayerSetExternalAudioOutput	回调audio数据到上层（供二次处理之用）
audio输出类型		SmartPlayerSetAudioOutputType	如果use_audiotrack设置为0，将会自动选择输出设备，如果设置为1，使用audiotrack模式，一对一回音消除模式下，请选用audiotrack模式
Video输出类型		NTRenderer.CreateRenderer（上层demo内）	第二个参数，如果是true，用openGLES绘制，false则用默认surfaceView
播放模式	缓冲时间设置	SmartPlayerSetBuffer	设置播放端缓存数据buffer，单位：毫秒，如不需buffer，设置为0
	首屏秒开	SmartPlayerSetFastStartup	设置快速启动后，如果CDN缓存GOP，实现首屏秒开
	低延迟模式	SmartPlayerSetLowLatencyMode	针对类似于直播娃娃机等期待超低延迟的使用场景，超低延迟播放模式下，延迟可达到200~400ms
	快速切换URL	SmartPlayerSwitchPlaybackUrl	快速切换播放url，快速切换时，只换播放source部分，适用于不同数据流之间，快速切换（如娃娃机双摄像头切换或高低分辨率流切换）
RTSP TCP/UDP模式设置		SmartPlayerSetRTSPTcpMode	设置RTSP TCP/UDP模式，如不设置，默认UDP模式
RTSP超时时间设置		SmartPlayerSetRTSPTimeout	设置RTSP超时时间，timeout单位为秒，必须大于0
设置RTSP TCP/UDP自动切换		SmartPlayerSetRTSPAutoSwitchTcpUdp	对于RTSP来说，有些可能支持rtp over udp方式，有些可能支持使用rtp over tcp方式 为了方便使用，有些场景下可以开启自动尝试切换开关, 打开后如果udp无法播放，sdk会自动尝试tcp, 如果tcp方式播放不了,sdk会自动尝试udp.
设置RTSP用户名和密码		SetRTSPAuthenticationInfo	如果RTSP URL已包含用户名和密码, 此接口设置的用户名和密码将无效. 就是说要用这个接口设置的用户名和密码去做认证, RTSP URL不能包含用户名和密码.
实时静音		SmartPlayerSetMute	实时静音
设置播放音量		SmartPlayerSetAudioVolume	播放端音量实时调节，范围[0,100]，0时为静音，100为原始流数据最大音量
设置是否禁用 Enhanced  RTMP		DisableEnhancedRTMP	disable enhanced RTMP, SDK默认是开启enhanced RTMP的
实时截图		CaptureImage	支持JPEG和PNG两种格式
视频镜像旋转	旋转	SmartPlayerSetRotation	设置顺时针旋转, 注意除了0度之外， 其他角度都会额外消耗性能，当前支持 0度，90度, 180度, 270度 旋转
	水平反转	SmartPlayerSetFlipHorizontal	设置视频水平反转
	垂直反转	SmartPlayerSetFlipVertical	设置视频垂直反转
设置URL		SmartPlayerSetUrl	设置需要播放或录像的RTMP/RTSP url
开始播放		SmartPlayerStartPlay	开始播放RTSP/RTMP流
停止播放		SmartPlayerStopPlay	停止播放RTSP/RTMP流
关闭播放实例		SmartPlayerClose	结束时必须调用close接口释放资源

功能支持

• 音频：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及以上版本。