如何在Android推流端内置轻量级RTSP服务

牛哥

为满足内网无纸化/电子教室等内网超低延迟需求，避免让用户配置单独的服务器，大牛直播SDK 在推送端发布了轻量级RTSP服务SDK。

内置轻量级RTSP服务后，延迟更低，体验更好(内网环境下，200-400毫秒)。

涉及相关库：libSmartPublisher.so
头文件：SmartPlayerJniV2.java SmartPublisherJniV2.java
Jar：smartavengine.jar

以下是接口详解：

Android内置轻量级RTSP服务SDK接口详解

SmartRTSPServerSDK

初始化RTSP Server

InitRtspServer

Init rtsp server(和UnInitRtspServer配对使用，即便是启动多个RTSP服务，也只需调用一次InitRtspServer，请确保在OpenRtspServer之前调用)

创建一个rtsp server

OpenRtspServer

创建一个rtsp server，返回rtsp server句柄

设置端口

SetRtspServerPort

设置rtsp server 监听端口, 在StartRtspServer之前必须要设置端口

设置鉴权用户名、密码

SetRtspServerUserNamePassword

设置rtsp server 鉴权用户名和密码, 这个可以不设置，只有需要鉴权的再设置

获取rtsp server当前会话数

GetRtspServerClientSessionNumbers

获取rtsp server当前的客户会话数, 这个接口必须在StartRtspServer之后再调用

启动rtsp server

StartRtspServer

停止rtsp server

StopRtspServer

关闭rtsp server

CloseRtspServer

UnInit rtsp server

UnInitRtspServer：UnInit rtsp server(和InitRtspServer配对使用，即便是启动多个RTSP服务，也只需调用一次UnInitRtspServer)

2. SmartRTSPServerSDK供Publisher调用的接口

设置rtsp的流名称

SetRtspStreamName：设置rtsp的流名称

给要发布的rtsp流设置rtsp server

AddRtspStreamServer：给要发布的rtsp流设置rtsp server, 一个流可以发布到多个rtsp server上，rtsp server的创建启动请参考OpenRtspServer和StartRtspServer接口

清除设置的rtsp server

ClearRtspStreamServer：清除设置的rtsp server

启动rtsp流

StartRtspStream：启动rtsp流

停止rtsp流

StopRtspStream：停止rtsp流

3. Android对应接口：

	/*+++++++++++++++内置轻量级RTSP服务SDK+++++++++++++++*/
	/*+++++++++++++++SmartRTSPServerSDK+++++++++++++++*/
	 * Init rtsp server(和UnInitRtspServer配对使用，即便是启动多个RTSP服务，也只需调用一次InitRtspServer，请确保在OpenRtspServer之前调用)
	 * @param ctx: get by this.getApplicationContext()
	 * @return {0} if successful
	public native int InitRtspServer(Object ctx);
	 * 创建一个rtsp server
   	 * @param reserve：保留参数传0
	 * @return rtsp server 句柄
	public native long OpenRtspServer(int reserve);
	 * 设置rtsp server 监听端口, 在StartRtspServer之前必须要设置端口
   	 * @param rtsp_server_handle: rtsp server 句柄
   	 * @param port: 端口号，可以设置为554,或者是1024到65535之间,其他值返回失败
	 * @return {0} if successful
	public native int SetRtspServerPort(long rtsp_server_handle, int port);
	 * 设置rtsp server 鉴权用户名和密码, 这个可以不设置，只有需要鉴权的再设置
   	 * @param rtsp_server_handle: rtsp server 句柄
   	 * @param user_name: 用户名(必须是英文)
   	 * @param password：密码(必须是英文)
	 * @return {0} if successful
	public native int SetRtspServerUserNamePassword(long rtsp_server_handle, String user_name, String password);
	 * 获取rtsp server当前的客户会话数, 这个接口必须在StartRtspServer之后再调用
   	 * @param rtsp_server_handle: rtsp server 句柄
	 * @return {当前rtsp server会话数}
	public native int GetRtspServerClientSessionNumbers(long rtsp_server_handle);
	 * 启动rtsp server
   	 * @param rtsp_server_handle: rtsp server 句柄
   	 * @param reserve: 保留参数传0
	 * @return {0} if successful
	public native int StartRtspServer(long rtsp_server_handle, int reserve);
	 * 停止rtsp server
   	 * @param rtsp_server_handle: rtsp server 句柄
	 * @return {0} if successful
	public native int StopRtspServer(long rtsp_server_handle);
	 * 关闭rtsp server
	 * @param rtsp_server_handle: rtsp server 句柄
	 * NOTE: 调用这个接口之后rtsp_server_handle失效，
	 * @return {0} if successful
	public native int CloseRtspServer(long rtsp_server_handle);
	 * UnInit rtsp server(和InitRtspServer配对使用，即便是启动多个RTSP服务，也只需调用一次UnInitRtspServer)
	 * @return {0} if successful
	public native int UnInitRtspServer();
	/*---------------SmartRTSPServerSDK---------------*/
	/*+++++++++++++++SmartRTSPServerSDK供Publisher调用的接口+++++++++++++++*/
	 * 设置rtsp的流名称
	 * @param handle: 推送实例句柄
   	 * @param stream_name: 流程名称，不能为空字符串，必须是英文
	 * 这个作用是: 比如rtsp的url是:rtsp://192.168.0.111/test, test就是设置下去的stream_name
	 * @return {0} if successful
	public native int SetRtspStreamName(long handle, String stream_name);
	 * 给要发布的rtsp流设置rtsp server, 一个流可以发布到多个rtsp server上，rtsp server的创建启动请参考OpenRtspServer和StartRtspServer接口
   	 * @param handle: 推送实例句柄
   	 * @param rtsp_server_handle：rtsp server句柄
	 * @param reserve：保留参数，传0
	 * @return {0} if successful
	public native int AddRtspStreamServer(long handle, long rtsp_server_handle, int reserve);
	 * 清除设置的rtsp server
	 * @param handle: 推送实例句柄
	 * @return {0} if successful
	public native int ClearRtspStreamServer(long handle);
	 * 启动rtsp流
	 * @param handle: 推送实例句柄
	 * @param reserve: 保留参数，传0
	 * @return {0} if successful
	public native int StartRtspStream(long handle, int reserve);
	 * 停止rtsp流
	 * @param handle: 推送实例句柄