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

原创 于 2025-06-07 17:46:56 发布
· 891 阅读 · 18 ·
版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#android #音视频 #rtmp播放器 #rtmpplayer #rtmp低延迟播放 #rtsp播放器 #大牛直播SDK

一、技术背景

自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.javaJNI 接口桥接类，建议放入 com.daniulive.smartplayer 包下
SmartPlayer.java上层封装类，用于统一操作
libSmartPlayer.soC++ 播放内核，放入对应架构 jniLibs 下

2. 权限配置（AndroidManifest.xml）

<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 库

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

4. Gradle ABI 配置

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

5. app_name 配置（授权验证）

<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为等比）
SmartPlayerSetSurfaceRenderFormatSurfaceView 渲染格式
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. 创建播放器并初始化配置

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. 设置播放事件监听

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. 停止与释放资源

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 播放模块具备超低延迟、高稳定性、强兼容性与良好扩展性，适用于安防监控、远程教育、互动直播、工业图传等多个领域。

博客
Python下的毫秒级延迟RTSP|RTMP播放器技术探究和AI视觉算法对接
03-07 1594
十年前，大牛直播SDK发布了跨平台的RTMP、RTSP毫秒级低延迟播放器，随着AI的爆发式普及和发展，加之大多视觉算法分析，都是用在Python下，Python下对视频流延迟的要求越来越高，本文将深入解析基于Python实现的RTSP/RTMP播放器，探讨其代码结构、实现原理以及优化策略，先看使用场景：交通监控：在城市交通管理中，通过低延迟播放器实时获取各个路口和路段的监控视频，交通管理人员可以及时查看路况，如是否有拥堵、事故等，并做出相应决策，如调整信号灯时长、派遣交警疏导等。
博客
iOS平台RTSP|RTMP直播播放器技术接入说明
09-18 2294
iOS平台RTSP、RTMP直播播放模块，延迟低、资源占有少，性能优异。由于设备和系统比较单一，优先考虑硬解码，除了基础播放外，我们还实现了实时快照、实时录像、实时回调YUV数据、实时音量调节等，实际体验下来，iOS平台RTMP和RTSP，可以轻松毫秒级。
博客
Android平台RTMP直播推送模块技术接入说明
08-07 1703
以上是大牛直播SDK的Android平台RTMP直播推送模块详细的对接说明，除了可以对接编码前各种类型的音视频数据外，模块还支持对接编码后音视频数据，并实现本地录像、快照等功能，除支持H.264外，RTMP推送模块还支持扩展H.265和Enhanced RTMP。感兴趣的开发者，可以单独跟我们探讨。
博客
Android平台RTSP|RTMP直播播放器技术接入说明
07-24 3000
以上是Android平台RTSP、RTMP直播播放模块对接说明，在此之前，我们针对SmartPlayer做过一些技术方面的探讨，从低延迟、音视频同步处理、多实例实现、解码效率、性能占用、解码后数据对接、实时截图、录像、网络抖动处理等各个维度，做过相关的技术分享。感兴趣的开发者，可以单独跟我们探讨。
博客
Android平台轻量级RTSP服务模块技术接入说明
07-17 1961
本文以大牛直播SDK Android平台Camera2Demo为例，启动RTSP服务、发布RTSP流之前，可以先选择视频分辨率、软编还是硬编码，音频是PCMA还是AAC编码等基础设置，其他参数的设置，可以参考下面InitAndSetConfig()。，实现本地的音视频数据（如摄像头、麦克风），编码后，汇聚到内置RTSP服务，对外提供可供拉流的RTSP URL，轻量级RTSP服务，其中，InitAndSetConfig()实现如下，通过调研SmartPublisherOpen()接口，生成推送实例句柄。
博客
基于arm64架构国产操作系统|Linux下的RTMP|RTSP低延时直播播放器开发探究
05-19 1722
arm64架构的国产操作系统|Linux下的RTMP、RTSP直播播放，延迟依然毫秒级，随着国产操作系统在传统行业的推进，越来越多的场景需要高稳定性高延迟低的RTMP|RTSP播放器，本文抛砖引玉，感兴趣的开发者可以跟我单独探讨。
博客
Android平台GB28181设备接入模块CSDN博客汇总
09-15 793
大牛直播SDK推出的Android平台GB28181接入SDK，可实现不具备国标音视频能力的 Android终端，通过平台注册接入到现有的GB/T28181—2016服务，可用于如。
博客
Android平台GB28181接入模块技术接入说明
12-19 3863
以上是大牛直播SDK发布的Android平台GB28181设备接入模块的相关说明，除了上述接口设计外，模块还可以扩展实现实时静音、实时快照、按需录像、实时音量调节等，可扩展性非常好。
博客
Android平台GB28181设备接入端如何支持跨网段语音对讲
12-13 1405
实际上，GB28181平台语音广播和语音对讲，特别是语音对讲，不光要解决传输跨网段问题，还可能要处理回音，噪音，增益控制等，这块，我们之前有了非常好的技术积累，处理起来轻车熟路，有需要测试的开发者，也可以私信联系我。两种技术方案虽然都可以实现语音对讲，方案1相对实现起来简单，但缺点明显，方案2技术优势有目共睹，更适合相对复杂的网络环境。遗憾的是，大多公司都没有实现，或者说市面上真正实现跨网段语音对讲的尚在少数，感兴趣的开发者可以酌情参考。
博客
Android平台GB28181设备接入模块相关博客概览
11-02 1277
Android平台GB28181设备接入模块，可实现不具备国标音视频能力的 Android终端，通过平台注册接入到现有的GB/T28181—2016服务，可用于如智能监控、智慧零售、智慧教育、远程办公、生产运输、智慧交通、车载或执法记录仪等场景。
博客
如何快速实现Android平台前端设备接入能力
03-08 6023
技术背景SIP(会话初始化协议)是在 IP网络上进行多媒体通信的应用层控制协议，以几种RFC的形式提供，其中最重要的是包含核心协议规范的RFC3261。该协议用于创建，修改和终止与一个或多个参与者的会话。通过会话，我们了解了一组进行通信的发送方和接收方，以及在通信过程中这些发送方和接收方保持的状态。会话的示例可以包括Internet电话呼叫，多媒体分发，多媒体会议，分布式计算机游戏等。SIP不是通信设备将需要的唯一协议，也不意味着是通用协议。SIP的目的仅仅是使通信成为可能，通信本身必须通过其他方式
博客
基于RTMP实现Linux|麒麟操作系统下屏幕|系统声音采集推送
07-22 1817
背景Windows操作系统自问世以来，以其简单易用的图形化界面操作受到大众追捧，为计算机的普及、科技的发展做出了不可磨灭的功绩，也慢慢的成为人们最依赖的操作系统。在中国，90％以上的办公环境都是Windows，学校和各种培训班的培训内容也都是Windows，Windows操作系统已经渗入到各行各业，人们已经习惯了Windows的界面和操作习惯，IT计算机和Windows已经被习以为常的画上了等号。但是，我们使用的软件真的安全吗？黑屏事件和棱镜门事件让很多乐观看待或尚未意识到信息安全问题的人们警醒，我
博客
麒麟操作系统|Linux下低延时RTMP|RTSP直播播放实现
07-21 2793
背景国产操作系统多为以Linux为基础二次开发的操作系统。2014年4月8日起，美国微软公司停止了对Windows XP SP3操作系统提供服务支持，这引起了社会和广大用户的广泛关注和对信息安全的担忧。而2020年对Windows7服务支持的终止再一次推动了国产系统的发展。工信部对此表示，将继续加大力度，支持Linux的国产操作系统的研发和应用，并希望用户可以使用国产操作系统。随着信息技术和互联网的快速发展普及，电子商务已经成为不可抗拒的现代商业潮流，云计算、大数据应用...
博客
Unity环境下RTMP推流+RTMP播放低延迟解决方案
06-13 4469
在本文之前，我们发布了Unity环境下的RTMP推流和RTMP|RTSP拉流低延迟的解决方案，今天做个整体汇总，权当抛砖引玉。关于如何实现Unity环境下低延迟的音视频解决方案。
博客
公网可用的RTMP、RTSP测试地址（更新于2021年3月）
03-16 1万+
好多博客提到的公网可测试的RTSP和RTMP URL大多都不用了，以下是大牛直播SDK(Github)于2021年3月亲测可用的几个URL，有其他可用的URL，也欢迎大家在评论区回复。RTMP流地址目前实际可用的有如下两个：1.rtmp://58.200.131.2:1935/livetv/hunantv (720*576)2.rtmp://ns8.indexforce.com/home/mystream (分辨率 800*450)RTSP流地址大熊兔（VOD）：rtsp:/..
博客
rtmp/rtsp/hls公网真正可用的测试地址
06-03 11万+
相信大家在调试播放器的时候，都有这样的困惑，很难找到合适的公有测试源，以下是大牛直播SDK（GitHub地址）整理的真正可用的直播地址源。其中，rtmp和rtsp的url，用我们播放器验证通过，hls的地址，用vlc验证通过。1. RTMP协议直播源香港卫视：rtmp://live.hkstv.hk.lxdns.com/live/hks (目前不可用，hks1、hks2可用)这个r...
博客
如何计算1920*1080分辨率的YUV或RGB图像数据占用大小？
06-08 933
精确计算图像格式的内存大小，是图像处理和视频开发中不可忽视的基础技能。特别在高性能场景下，对内存控制、帧率管理、并发处理都有重要意义。开发者不仅要熟悉各类格式，还需理解其带来的性能差异和工程影响。
博客
打造毫秒级延迟体验：基于大牛直播SDK的全平台RTMP播放器开发实录
06-07 874
大牛直播SDK是一款跨平台、超低延迟的RTMP播放器解决方案，支持H.264/H.265硬解码、多实例并发播放，提供100-250ms的端到端延迟。其核心优势包括：1.全平台兼容性，支持Android/iOS/Windows；2.毫秒级首屏秒开；3.完善的网络容错与自适应能力；4.丰富的音视频控制接口。通过分层架构设计（Java接口层/JNI桥接层/C++核心引擎），实现了高性能与易集成的平衡。典型应用于互动直播、监控安防等场景，实测内存占用低，支持多种渲染控制和数据回调功能，为开发者提供稳定高效的RTMP
博客
基于SmartPlayer的超低延迟RTSP播放器全平台开发实录
06-06 611
《跨平台超低延迟RTSP播放器开发实践》重点解析了大牛直播SDK在实时流媒体播放领域的技术突破。该SDK支持Windows/Linux/Android/iOS多平台，通过模块化架构实现软硬解码切换、H.265优化及多实例播放控制，将延迟压缩至100-250ms。其特色包括自研RTSP协议栈、网络自适应机制、多渲染模式支持，以及解码前后数据回调体系。相比FFmpeg和VLC，该方案在延迟控制、移动兼容性和接入便捷性方面具有明显优势，特别适用于安防监控、无人机等低延迟场景。SDK还将持续扩展协议支持，打造全场景
博客
从底层到场景：大牛直播SDK在RTSP/RTMP播放领域的全面突破
06-06 585
在音视频直播技术日新月异的今天，大牛直播SDK凭借其卓越的性能、丰富的功能和广泛的应用，确立了在行业中的领先地位。无论是企业级应用还是个人开发项目，选择大牛直播SDK，都是迈向高效、稳定、专业音视频解决方案的重要一步。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值