libstreaming 源码分析一之RTSP连接

libstreaming（github下载网站： https://github.com/fyhertz/libstreaming  ）

一、libstreaming概述

 
功能介绍：实现android视频直播的库，主要实现的功能有RTSP协议、H263/H264编码、RTP/RTCP协议打包等。

libstreaming is an API that allows you, with only a few lines of code, to stream the camera and/or microphone of an android powered device using RTP over UDP.
Android 4.0 or more recent is required.
Supported encoders include H.264, H.263, AAC and AMR.

The first step you will need to achieve to start a streaming session to some peer is called 'signaling'. During this step you will contact the receiver and send a description of the incomming streams. You have three ways to do that with libstreaming.
With the RTSP client: if you want to stream to a Wowza Media Server, it's the way to go. The
example 3illustrates that use case.
With the RTSP server: in that case the phone will act as a RTSP server and wait for a RTSP client to request a stream. This use case is illustated in the
example 1.
Or you use libstreaming without using the RTSP protocol at all, and signal the session using SDP over a protocol you like. The
example 2 illustrates that use case.

The full javadoc documentation of the API is available here: http://majorkernelpanic.com/libstreaming/doc-v4

二、视频直播模型（图一）



三、example 示例

libstreaming 库的作者提供了3个示例demo，见（一）。
example1 是将libstreaming作为 RTSP server ，在手机上安装并启动net.majorkernelpanic.streaming.rtsp.RtspServer，在PC上用vlc打开rtsp://your rtspserver ip:8086，即可实现视频直播。
example2 是利用其它协议实现视频直播，未研究，此略。
example3 是将libstreaming作为 RTSP client ，通过net.majorkernelpanic.streaming.rtsp.RtspCilent将视频流push到wowza服务器，在PC上用VLC打开rtsp://your wowzastreaming ip:1935/live/test.stream，即可实现视频直播。

注意RtspServer与RtspClient的区别，也就是流媒体pull与push的区别。见下图。





 

因为可能有多个视频采集端，我们需要采集端主动推送视频流至流媒体服务器。
注意：libstreaming中RtspClient协议只能成功连接wowza流媒体服务器，若要rtsp连接至dss，需要修改RtspClient。

四、example3流程

example3只要一个MainActivity.java。主要是为Session、RtspClient设置初值，如分辨率、帧率、编码格式等。
除了MainActivity.java，其他java文件包名均为“net.majorkernelpanic.streaming”。大致流程如下：

（1）开启相机预览

MainActivity.java



Session.java



VideoStream.java：开启相机预览



（2）RTSP连接

MainActivity.java： 点击button “R.id.start”，进入 toggleStream 方法，关键代码：



前面已经根据输入内容，设置了连接wowza服务器的地址、端口、用户名和密码。

RtspClient.java：发送rtsp协议，关键代码







其中，sendRequestAnnounce() 、 sendRequestSetup() 、 sendRequestRecord() 分别发送RTSP中的 ANNOUNCE、SETUP、RECORD方法至wowza。下面是打印的log：



[align=left]
[/align]
[align=left]从log信息可以看出rtsp连接成功，只需在播放端用vlc播放地址：rtsp://wowza ip:1935/live/test.stream 。关于RTSP协议的分析，此处不做详细说明。[/align]