基于大牛直播SDK的 Android RTSP/RTMP 播放器集成指南

📘 1. 概述

本 SDK 是一款成熟的跨平台 RTSP 和 RTMP 播放核心，支持 H.264/H.265 视频、AAC / PCMA / PCMU / Speex 音频，具备超低延迟、资源占用低、可组合扩展的特点，适用于工业监控、智慧教育、执法记录、远程协作等高性能场景。

✅ Android 播放器支持功能一览

📱 基础能力

🎥 画面与渲染控制

🔊 音视频数据与回调能力

📸 快照与录像

🌐 网络与协议支持

⚙️ 2. 系统要求

🔧 3. 集成准备

3.1 文件组织

• 将 SmartPlayerJniV2.java 放入 ***.daniulive.smartplayer 包；

• 引入 Smartavengine.jar；

• 将 libSmartPlayer.so (各ABI版本) 拷贝至项目 jniLibs/ 对应目录。

3.2 AndroidManifest 权限声明

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

3.3 Native 库加载 & Gradle 配置

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

3.4 授权 App 名称设置

• 如需集成到自己系统测试，请用大牛直播SDK的app name，授权版按照授权app name正常使用即可；
• 如何改app-name，strings.xml做以下修改：

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

📌 4. 接口说明（模块分类）

4.1 初始化与播放配置

4.2 播放控制

4.3 解码与渲染设置

4.4 网络协议策略配置

4.5 音频与数据回调支持

4.6 截图、旋转与翻转

📌 4.7 录像功能配置

支持将播放中的 RTSP / RTMP 视频流本地录制为 MP4 文件，适用于取证存档、断点缓存、边播放边录制等场景。

✅ 大牛直播SDK Android 播放器功能调用示例

☑ 1. 播放器初始化

long handle = libPlayer.SmartPlayerOpen(context);
if (handle == 0) {
    Log.e(TAG, "SmartPlayerOpen failed");
    return;
}

☑ 2. 设置播放地址（支持 RTSP / RTMP）

libPlayer.SmartPlayerSetUrl(handle, "rtsp://192.168.1.100/live.sdp");
// 或者
libPlayer.SmartPlayerSetUrl(handle, "rtmp://live.mycdn.***/app/stream");

☑ 3. 播放控制（开始 / 停止 / 释放）

libPlayer.SmartPlayerStartPlay(handle);
libPlayer.SmartPlayerStopPlay(handle);
libPlayer.SmartPlayerClose(handle);

☑ 4. 播放性能优化参数

libPlayer.SmartPlayerSetFastStartup(handle, 1);           // 首屏秒开
libPlayer.SmartPlayerSetLowLatencyMode(handle, 1);        // 低延迟模式
libPlayer.SmartPlayerSetBuffer(handle, 200);              // 缓冲时间（毫秒）

☑ 5. 解码与渲染配置

libPlayer.SetSmartPlayerVideoHWDecoder(handle, 1);        // 启用H.264硬解
libPlayer.SetSmartPlayerVideoHevcHWDecoder(handle, 1);    // 启用H.265硬解
libPlayer.SmartPlayerSetSurface(handle, surface);         // 设置渲染Surface
libPlayer.SmartPlayerSetRenderScaleMode(handle, 0);       // 等比例显示
libPlayer.SmartPlayerSetSurfaceRenderFormat(handle, 1);   // ARGB8888格式
libPlayer.SmartPlayerSetSurfaceAntiAlias(handle, 1);      // 抗锯齿

☑ 6. 网络协议设置

libPlayer.SmartPlayerSetRTSPTcpMode(handle, 1);           // 强制RTSP TCP模式
libPlayer.SmartPlayerSetRTSPTimeout(handle, 10);          // 设置请求超时（秒）
libPlayer.SmartPlayerSetRTSPAutoSwitchTcpUdp(handle, 1);  // 自动切换UDP/TCP
libPlayer.SmartPlayerSwitchPlaybackUrl(handle, newUrl);   // 快速切流

☑ 7. 音频控制

libPlayer.SmartPlayerSetAudioVolume(handle, 80);          // 设置音量
libPlayer.SmartPlayerSetMute(handle, 1);                  // 静音
libPlayer.SmartPlayerSetAudioOutputType(handle, 1);       // 选择 AudioTrack 输出

☑ 8. 外部音视频数据回调（AI识别/转推等场景）

libPlayer.SmartPlayerSetExternalAudioOutput(playerHandle, new PlayerExternalPcmOutput());   // 获取PCM音频帧

libPlayer.SmartPlayerSetExternalRender(playerHandle, new I420ExternalRender(imageSavePath));        // 获取YUV帧

libPlayer.SmartPlayerSetExternalRender(playerHandle, new RGBAExternalRender(imageSavePath));    //获取RGB帧

☑ 9. 视频画面操作（截图/旋转/翻转）

libPlayer.CaptureImage(handle, "/sdcard/snap1.jpg");      // 截图 JPEG
libPlayer.SmartPlayerSetRotation(handle, 90);             // 顺时针旋转90°
libPlayer.SmartPlayerSetFlipHorizontal(handle, 1);        // 水平翻转
libPlayer.SmartPlayerSetFlipVertical(handle, 1);          // 垂直翻转

☑ 10. 录像控制

String recDir = PathUtils.getRecordDir(context);
libPlayer.SmartPlayerCreateFileDirectory(recDir);
libPlayer.SmartPlayerSetRecorderDirectory(handle, recDir);
libPlayer.SmartPlayerSetRecorderFileMaxSize(handle, 200); // 单文件最大200MB
libPlayer.SmartPlayerSetRecorderVideo(handle, 1);
libPlayer.SmartPlayerSetRecorderAudio(handle, 1);
libPlayer.SmartPlayerSetRecorderAudioTranscodeAAC(handle, 1);

// 启动录像
libPlayer.SmartPlayerStartRecorder(handle);

// 停止录像
libPlayer.SmartPlayerStopRecorder(handle);

☑ 11. 状态判断与异常处理

if (libPlayer != null && handle != 0 && isPlaying) {
    libPlayer.SmartPlayerStopPlay(handle);
    libPlayer.SmartPlayerClose(handle);
}

📊 6. 功能支持一览

Android平台RTMP播放器时延视频

Android平台RTSP播放器时延视频

⚙️ 7. 扩展使用建议

• 多模块组合：可组合使用播放、录制、流转发、RTSP 服务端模块，共同发挥功能（例如播放 + 本地重录 + 转发 + RTSP 服务）。

• 接入 AI 分析能力：通过视频帧接口，可实时进行边缘 AI 推理或图像分析。

• 录像插件使用：支持录制 RTSP / RTMP 流，并支持音频转 AAC 和多种录像模式。

• 适用场景举例：教学直播、工业巡检、城市安防、执法记录仪等需要低延迟、高稳定性的场合。

✅ 8. 结语

本 Android 版接入指南 基于 大牛直播SDK 自 2015 年以来不断演进的 RTSP/RTMP 播放模块编写，涵盖了从基础接入流程、接口分类说明、参数配置建议，到典型调用示例与功能能力矩阵的完整内容，旨在帮助开发者快速集成一套 稳定、高兼容、低延迟 的直播播放能力。

得益于 大牛直播SDK 模块化设计与跨平台支持，该播放端不仅可独立使用，还可灵活对接同系列的推流端、轻量级 RTSP 服务模块、Unity 渲染模块等，广泛适用于工业监控、远程协作、教育培训、嵌入式视觉等场景。

附录：Android平台RTSP|RTMP直播播放器技术接入说明