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

2024-09-05 15:45:41 浏览数 (1)

​技术背景

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

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

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

前提条件

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

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

代码语言：javascript复制
<string name="app_name">SmartPlayerSDKDemo</string>

SmartPlayer目录

文件名

作用

SmartPlayerV2

RTSP|RTMP直播播放器Demo工程源码

SmartPlayerV2appsrcmainjniLibs

smartavengine.jar和libSmartPlayer.so

SmartPlayerV2appsrcmainjavacomdaniulive smartplayerSmartPlayerJniV2.java

播放器头文件

SmartPlayerV2appsrcmainjavacomdaniulive smartplayerSmartPlayer.java

接口调用示例

准备工作

  • 确保SmartPlayerJniV2.java放到com.daniulive.smartplayer包名下(可在其他包名下调用)；
  • Smartavengine.jar加入到工程；
  • 拷贝SmartPlayerV2appsrcmainjniLibsarmeabi-v7a、 SmartPlayerV2appsrcmainjniLibsarm64-v8a、SmartPlayerV2appsrcmainjniLibsx86和SmartPlayerV2appsrcmainjniLibsx86_64 下 libSmartPlayer.so到工程；
  • AndroidManifast.xml添加相关权限：
代码语言：java复制
<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：
代码语言：java复制
static {  
    System.loadLibrary("SmartPlayer");
}
  • build.gradle配置32/64位库：
代码语言：java复制
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及以上版本。
快直播 直播SDK 播放器SDK 视频播放器 超级播放器AndroidRTSP播放器 AndroidRTMP播放器 安卓rtmp播放器 安卓rtsp播放

0 人点赞