Android 平台RTSP/RTMP播放器SDK接入说明

音视频牛哥2025-06-10 9:24

一、技术背景

自2015年起，大牛直播SDK持续深耕音视频直播领域，自主研发并迭代推出跨平台 RTSP/RTMP 播放模块，具备如下核心优势：

  • 全平台兼容：支持 Android/iOS/Windows/Linux 等主流系统；

  • 超低延迟：公网端到端延迟可低至 100ms~250ms；

  • 性能强劲：CPU 占用低，解码效率高；

  • 稳定性高：适配复杂网络环境，支持自动重连、快照、断网恢复等能力；

  • 接口全面：支持软硬解、数据回调、多实例、实时截图、录像等。

本文将以 Android 平台为例，详解如何对接并使用大牛直播 RTSP/RTMP 播放模块（SmartPlayerV2）。

二、系统要求

项目 支持情况
Android系统 Android 5.1 及以上版本
架构支持 armv7, arm64, x86, x86_64
渲染机制 SurfaceView / OpenGL ES / TextureView

三、准备工作

华为HONOR X10同时播放4路1080P RTSP流

1. 引入资源文件

将以下资源文件集成至工程：

|-------------------------|-----------------------------------------------|
| 文件名称 | 说明 |
| SmartPlayer.jar | 上层接口封装，放入 libs/ 目录 |
| SmartPlayerJniV2.java | JNI 接口桥接类，建议放入 com.daniulive.smartplayer 包下 |
| SmartPlayer.java | 上层封装类，用于统一操作 |
| libSmartPlayer.so | C++ 播放内核，放入对应架构 jniLibs 下 |

2. 权限配置（AndroidManifest.xml）

java 复制代码 
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />

3. 加载 native 库

java 复制代码 
static {
    System.loadLibrary("SmartPlayer");
}

4. Gradle ABI 配置

java 复制代码 
splits {
    abi {
        enable true
        reset()
        include 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64'
        universalApk true
    }
}

5. app_name 配置（授权验证）

java 复制代码 
<string name="app_name">SmartPlayerSDKDemo</string>

四、核心接口说明（SmartPlayerJniV2）

1. 初始化与控制流程

|------------------------|---------------------|
| 接口 | 说明 |
| SmartPlayerOpen | 创建播放器实例，返回句柄 |
| SmartPlayerSetUrl | 设置播放 URL（RTSP/RTMP） |
| SmartPlayerStartPlay | 启动播放 |
| SmartPlayerStopPlay | 停止播放 |
| SmartPlayerClose | 释放播放器实例 |

2. 解码与渲染配置

|-------------------------------------|-------------------------|
| 接口 | 说明 |
| SetSmartPlayerVideoHWDecoder | 设置 H.264 硬解模式 |
| SetSmartPlayerVideoHevcHWDecoder | 设置 H.265 硬解模式 |
| SmartPlayerSetSurface | 绑定 Surface 用于画面显示 |
| SmartPlayerSetHWRenderMode | 设置 MediaCodec 绘制（兼容性更高） |
| SmartPlayerSetRenderScaleMode | 设置画面缩放填充模式（1为等比） |
| SmartPlayerSetSurfaceRenderFormat | SurfaceView 渲染格式 |
| SmartPlayerSetSurfaceAntiAlias | 开启抗锯齿（性能损耗，谨慎使用） |

3. 网络与播放优化

|--------------------------------------|---------------------|
| 接口 | 说明 |
| SmartPlayerSetBuffer | 设置播放缓存（单位：ms） |
| SmartPlayerSetFastStartup | 启用首屏秒开 |
| SmartPlayerSetLowLatencyMode | 启用低延迟模式 |
| SmartPlayerSwitchPlaybackUrl | 快速切换播放 URL |
| SmartPlayerSetRTSPTcpMode | 设置 RTSP TCP 模式 |
| SmartPlayerSetRTSPTimeout | 设置 RTSP 超时时间（单位：秒） |
| SmartPlayerSetRTSPAutoSwitchTcpUdp | 自动 TCP/UDP 切换 |
| DisableEnhancedRTMP | 禁用 Enhanced RTMP 支持 |

4. 音视频控制与扩展功能

|-------------------------------------|-----------------------------|
| 接口 | 说明 |
| SmartPlayerSetMute | 实时静音 |
| SmartPlayerSetAudioVolume | 设置音量（0~100） |
| CaptureImage | 实时截图（支持 JPEG/PNG） |
| SmartPlayerSetRotation | 视频旋转（0/90/180/270°） |
| SmartPlayerSetFlipHorizontal | 水平镜像 |
| SmartPlayerSetFlipVertical | 垂直镜像 |
| SmartPlayerSetExternalRender | 回调解码后 YUV/RGB 数据供自定义渲染 |
| SmartPlayerSetExternalAudioOutput | 音频数据回调 |
| SmartPlayerSetAudioOutputType | 选择音频输出类型（AudioTrack/OpenSL） |

五、播放流程参考（Java 示例）

1. 创建播放器并初始化配置

java 复制代码 
SmartPlayerJniV2 libPlayer = new SmartPlayerJniV2();
long playerHandle = libPlayer.SmartPlayerOpen(getApplicationContext());
libPlayer.SmartPlayerSetUrl(playerHandle, "rtmp://xxx/live/stream");
libPlayer.SmartPlayerSetBuffer(playerHandle, 300);
libPlayer.SmartPlayerSetLowLatencyMode(playerHandle, 1);
libPlayer.SmartPlayerSetSurface(playerHandle, surfaceView);
libPlayer.SmartPlayerStartPlay(playerHandle);

2. 设置播放事件监听

java 复制代码 
class EventHandeV2 implements NTSmartEventCallbackV2 {
	@Override
	public void onNTSmartEventCallbackV2(long handle, int id, long param1,
										 long param2, String param3, String param4, Object param5) {

		//Log.i(TAG, "EventHandeV2: handle=" + handle + " id:" + id);

		String player_event = "";

		switch (id) {
			case NTSmartEventID.EVENT_DANIULIVE_ERC_PLAYER_STARTED:
				player_event = "开始..";
				break;
			case NTSmartEventID.EVENT_DANIULIVE_ERC_PLAYER_CONNECTING:
				player_event = "连接中..";
				break;
			case NTSmartEventID.EVENT_DANIULIVE_ERC_PLAYER_CONNECTION_FAILED:
				player_event = "连接失败..";
				break;
			case NTSmartEventID.EVENT_DANIULIVE_ERC_PLAYER_CONNECTED:
				player_event = "连接成功..";
				break;
			case NTSmartEventID.EVENT_DANIULIVE_ERC_PLAYER_DISCONNECTED:
				player_event = "连接断开..";
				break;
			case NTSmartEventID.EVENT_DANIULIVE_ERC_PLAYER_STOP:
				player_event = "停止播放..";
				break;
			case NTSmartEventID.EVENT_DANIULIVE_ERC_PLAYER_RESOLUTION_INFO:
				player_event = "分辨率信息: width: " + param1 + ", height: " + param2;
				break;
			case NTSmartEventID.EVENT_DANIULIVE_ERC_PLAYER_NO_MEDIADATA_RECEIVED:
				player_event = "收不到媒体数据，可能是url错误..";
				break;
			case NTSmartEventID.EVENT_DANIULIVE_ERC_PLAYER_SWITCH_URL:
				player_event = "切换播放URL..";
				break;
			case NTSmartEventID.EVENT_DANIULIVE_ERC_PLAYER_CAPTURE_IMAGE:
				player_event = "快照: " + param1 + " 路径：" + param3;

				if (param1 == 0)
					player_event = player_event + ", 截取快照成功";
				 else
					player_event = player_event + ", 截取快照失败";

				if (param4 != null && !param4.isEmpty())
					player_event += (", user data:" + param4);

				break;

			case NTSmartEventID.EVENT_DANIULIVE_ERC_PLAYER_RECORDER_START_NEW_FILE:
				player_event = "[record]开始一个新的录像文件 : " + param3;
				break;
			case NTSmartEventID.EVENT_DANIULIVE_ERC_PLAYER_ONE_RECORDER_FILE_FINISHED:
				player_event = "[record]已生成一个录像文件 : " + param3;
				break;

			case NTSmartEventID.EVENT_DANIULIVE_ERC_PLAYER_START_BUFFERING:
				Log.i(TAG, "Start Buffering");
				break;

			case NTSmartEventID.EVENT_DANIULIVE_ERC_PLAYER_BUFFERING:
				Log.i(TAG, "Buffering:" + param1 + "%");
				break;

			case NTSmartEventID.EVENT_DANIULIVE_ERC_PLAYER_STOP_BUFFERING:
				Log.i(TAG, "Stop Buffering");
				break;

			case NTSmartEventID.EVENT_DANIULIVE_ERC_PLAYER_DOWNLOAD_SPEED:
				player_event = "download_speed:" + param1 + "Byte/s" + ", "
						+ (param1 * 8 / 1000) + "kbps" + ", " + (param1 / 1024)
						+ "KB/s";
				break;

			case NTSmartEventID.EVENT_DANIULIVE_ERC_PLAYER_RTSP_STATUS_CODE:
				Log.e(TAG, "RTSP error code received, please make sure username/password is correct, error code:" + param1);
				player_event = "RTSP error code:" + param1;
				break;
		}

		if (player_event.length() > 0) {
			Log.i(TAG, player_event);
			Message message = new Message();
			message.what = PLAYER_EVENT_MSG;
			message.obj = player_event;
			handler.sendMessage(message);
		}
	}
}

3. 停止与释放资源

java 复制代码 
libPlayer.SmartPlayerStopPlay(playerHandle);
libPlayer.SmartPlayerClose(playerHandle);

六、多实例播放封装（LibPlayerWrapper）

推荐封装 SmartPlayer 播放实例为 LibPlayerWrapper 类，实现多实例管理、资源释放、播放状态判断等能力，便于集成。

封装内容包括：

  • 打开与关闭播放器

  • 设置 Surface/播放参数

  • 启动/停止播放

  • 设置静音、音量、截图等控制

详见源码文件 LibPlayerWrapper.java

七、附录：支持功能一览

  • 支持协议：RTMP、RTSP（含鉴权、TCP/UDP）

  • 音频编码：AAC、Speex、PCMA、PCMU

  • 视频编码：H.264、H.265

  • 渲染方式：SurfaceView/OpenGL ES/TextureView

  • 解码方式：软解、硬解（支持自动降级）

  • 回调接口：解码前、解码后、下载速度、事件状态

  • 附加能力：截图、旋转、镜像、切流、低延迟播放、首屏秒开、多实例支持、录像功能扩展

八、总结

本文全面介绍了大牛直播 SDK 在 Android 平台下的 RTSP/RTMP 播放模块集成方式，重点涵盖依赖配置、接口调用、播放控制、多实例封装等内容。SmartPlayer 播放模块具备超低延迟、高稳定性、强兼容性与良好扩展性，适用于安防监控、远程教育、互动直播、工业图传等多个领域。

相关推荐
vocal13 分钟前
我的安卓第一课：四大组件之一Service
android
勿芮介42 分钟前
【开发技术】.Net使用FFmpeg视频特定帧上绘制内容
ffmpeg·.net·音视频
春末的南方城市4 小时前
腾讯开源视频生成工具 HunyuanVideo-Avatar，上传一张图+一段音频，就能让图中的人物、动物甚至虚拟角色“活”过来，开口说话、唱歌、演相声！
人工智能·计算机视觉·自然语言处理·aigc·音视频·视频生成
用户2018792831674 小时前
如何利用AI工具快速学习Android源码
android
君鼎5 小时前
音视频——I2S 协议详解
嵌入式硬件·音视频
aningxiaoxixi7 小时前
Android Framework 之 AudioDeviceBroker
android·windows·ffmpeg
~Yogi7 小时前
今日学习：工程问题（场景题）
android·学习
奔跑吧 android7 小时前
【android bluetooth 框架分析 04】【bt-framework 层详解 1】【BluetoothProperties介绍】
android·bluetooth·bt·aosp13
移动开发者1号7 小时前
Android Activity状态保存方法
android·kotlin
热门推荐
01【图像处理与机器视觉】XJTU期末考点02从零安装 LLaMA-Factory 微调 Qwen 大模型成功及所有的坑03KGG转MP3工具|非KGM文件|解密音频04Coze扣子平台完整体验和实践（附国内和国际版对比）05YOLOv8入门 | 重要性能衡量指标、训练结果评价及分析及影响mAP的因素【发论文关注的指标】06【SpeedAI科研小助手】2分钟极速解决知网维普重复率、AIGC率过高，一键全文降！文件格式不变，公式都保留的！07零代码入门 | Coze——让大模型接入自己的数据库08海康Visionmaster-常见问题排查方法-启动阶段09DeepSeek各版本说明与优缺点分析10R-tree详解