LIVE555再学习 -- testRTSPClient 源码分析
现在开讲 testRTSPClient。在官网这这样一段介绍，参看：RTSP client
翻译下来就是：
testRTSPClient 是一个命令行程序，显示如何打开和接收由 RTSP URL 指定的媒体流，即以rtsp：//开头的URL
在这个演示应用中，接收到的音频/视频数据什么也没有。 但是，您可以在自己的应用程序中使用和调整此代码（例如）解码和播放接收到的数据。
openRTSP 类似于“testRTSPClient”，但具有更多的功能。 这是一个命令行程序，它与“testRTSPClient”不同，旨在用作一个完整的全功能应用程序（而不是在其他应用程序中使用其代码）。 也正应为如此，openRTSP”源代码并不是最好的例子，因为它包含很多额外的选项，大多数你可能不需要。
所以，如果您正在寻找如何使用“LIVE555 Streaming Media”代码构建自己的RTSP / RTP媒体播放器客户端
在这个演示应用中，接收到的音频/视频数据什么也没有。 但是，您可以在自己的应用程序中使用和调整此代码（例如）解码和播放接收到的数据。
openRTSP 类似于“testRTSPClient”，但具有更多的功能。 这是一个命令行程序，它与“testRTSPClient”不同，旨在用作一个完整的全功能应用程序（而不是在其他应用程序中使用其代码）。 也正应为如此，openRTSP”源代码并不是最好的例子，因为它包含很多额外的选项，大多数你可能不需要。
所以，如果您正在寻找如何使用“LIVE555 Streaming Media”代码构建自己的RTSP / RTP媒体播放器客户端
应该使用“testRTSPClient”应用程序代码（也在“testProgs”目录中）作为模型。
一、源码解析
参看：庖丁解牛-----Live555源码彻底解密(根据testRTSPClient讲解)
参看：庖丁解牛-----Live555源码彻底解密(testRTSPClient流程图)
参看：live555/testProgs/testRTSPClient.cpp
推荐使用 ctags 来查看源码进行分析
参看：日常生活小技巧 -- vim 中 ctags 的安装和使用
下面所说的跳转查看就是 ctrl+}，然后看完后返回跳转前位置 ctrl+t
（1）首先从 testRTSPClient.cpp 的 main函数开始看起
上图可以看到，创建BasicTaskScheduler 和 BisicUsageEnvironment对象。
重点是 openURL 函数，然后 ctrl+] 跳转查看 openURL 的定义
首先通过 ourRTSPClient::createNew 函数最终会调用 ourRTSPClient 的构造函数，基类 RTSPClient 的指针指向派生类 ourRTSPClient 对象，并且最终会调用 RTSPClient 的构造函数；
sendDescribeCommand 函数往服务器端发送 Describe 请求；continueAfterDESCRIBE 为回调函数；在DoEventLoop 中的 SingleStep 中调用；
RTP over tcp 还是udp 由宏 #define REQUEST_STREAMING_OVER_TCP False 进行控制;
（2）然后跳转查看 sendDescribeCommand
（3）然后跳转查看 RequestRecord
可看到将回调函数保存在 RequestRecord 类的 fHandler 上;
（4）然后跳转查看 fHandler
根据上图可看到 RequestRecord 类定义。所以说 在 SendRequest 中调用 RequestRecord 的构造函数.
（5）然后返回到（2），跳转查看 sendRequest
函数有点长，自行查看吧。
然后其中有一部分：
（6）然后跳转查看 openConnection
parseRTSPURL
setupStreamSocket
connectToServer
setBackgroundHandling
incomingDataHandler
setupStreamSocket
connectToServer
setBackgroundHandling
incomingDataHandler
这几个函数下面需要一一看一下，根据名字也可能看出它们是什么作用的。
（7）然后跳转查看 setBackgroundHandling
上图为 setBackgroundHandling 函数定义，其中 HandlerSet* fHandlers 连上服务器后，调用incomingDataHandler 回调函数;
（8）然后跳转查看 assignHandler
（9）然后跳转查看 lookupHandler
回顾（6）~（9）
openConnection 函数用来连接到服务器；在该函数中首先调用
parseRTSPURL 解析客户端的 RtspURL；然后建立socket()，然后
connectToServer 连接到服务器;；
incomingDataHandler 为回调函数；
incomingDataHandler 函数，最终赋值给了 handler->handlerProc = handlerProc;
那么我们接下来就看看这几个函数。
（10）然后返回到（6），跳转查看 parseRTSPURL
函数有点长，自行查看吧。
（11）然后返回到（6），跳转查看 setupStreamSocket
建立 socket 的函数为 setupStreamSocket，该函数建立的是一个 tcp 的 socket;
setupStreamSocket 函数首先创建 socket，然后设置 SO_REUSEADDR socket 属性；并且调用 bind 函数绑定socket；最后将 socket 设置成非阻塞形式;
setupStreamSocket 函数首先创建 socket，然后设置 SO_REUSEADDR socket 属性；并且调用 bind 函数绑定socket；最后将 socket 设置成非阻塞形式;
（12）然后返回到（6），跳转查看 connectToServer
主要起作用的是这句话：
envir().taskScheduler().setBackgroundHandling(socketNum,SOCKET_WRITABLE|SOCKET_EXCEPTION,(TaskScheduler::BackgroundHandlerProc*)&connectionHandler,
envir().taskScheduler().setBackgroundHandling(socketNum,SOCKET_WRITABLE|SOCKET_EXCEPTION,(TaskScheduler::BackgroundHandlerProc*)&connectionHandler,
然后
setBackgroundHandling 我们在 （7）里看过了。现在看一下 connectionHandler
（12）然后跳转查看 connectionHandler
（13）然后跳转查看 connectionHandler1
（14）然后返回到（1），跳转查看 doEventLoop
这里如果想要该程序退出，在外面将 *watchVariable=1 就可以了
（15）然后跳转查看 SingleStep
函数有点长，自行查看吧
connectionHandler 在 SingleStep 函数中会调用，调用如下：
(*handler->handlerProc)(handler->clientData,resultConditionSet);
(*handler->handlerProc)(handler->clientData,resultConditionSet);
到此，将数据接收部分的源码分析完了。
