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

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

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

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

以下是接口详解：

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

1. 以下是接口详解：

   Android内置轻量级RTSP服务SDK接口详解
   调用描述	接口	接口描述
   常规功能	Android RTMP推送端所有功能依然有效，亦可同时推送RTMP
   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
   停止rtsp server	StopRtspServer	停止rtsp server
   关闭rtsp server	CloseRtspServer	关闭rtsp server
   UnInit rtsp server	UnInitRtspServer	UnInit rtsp server(和InitRtspServer配对使用，即便是启动多个RTSP服务，也只需调用一次UnInitRtspServer)
   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流

2. 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: 推送实例句柄
	 *
	 * @return {0} if successful
	 */
	public native int StopRtspStream(long handle);
	/*---------------SmartRTSPServerSDK供Publisher调用的接口---------------*/

	/*---------------内置轻量级RTSP服务SDK---------------*/