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

一、技术背景

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

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

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

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

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

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

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

二、系统要求

三、准备工作

1. 引入资源文件

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

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. 初始化与控制流程

2. 解码与渲染配置

3. 网络与播放优化

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

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