一个基于JRTPLIB的轻量级RTSP客户端(myRTSPClient)——实现篇：（三）用户接口层之RTSP命令

截至版本1.2.3，myRtspClient函数库共支持以下6个RTSP命令（RFC 2326）：

（1）OPTIONS

（2）DESCRIBE

（3）SETUP

（4）PLAY

（5）PAUSE

（6）TEARDOWN

对应的接口函数都以“Do”开头，如“DoOPTIONS”。各个接口函数写法相似，大同小异，差异部分会在后续章节做说明，现以DoOPTIONS()和DoPLAY()举例。

一、ErrorType RtspClient::DoOPTIONS(string uri)

 ErrorType RtspClient::DoOPTIONS(string uri)
 {
     string RtspUri("");
     int Sockfd = -;

     if(uri.length() != ) {
         RtspUri.assign(uri);
         RtspURI.assign(uri);
     }
     else if(RtspURI.length() != ) RtspUri.assign(RtspURI);
     else return RTSP_INVALID_URI;

     Sockfd = CreateTcpSockfd(RtspUri);
     if(Sockfd < ) return RTSP_INVALID_URI;

     string Cmd("OPTIONS");
     stringstream Msg("");
     Msg << Cmd << " " << RtspUri << " " << "RTSP/" << VERSION_RTSP << "\r\n";
     Msg << "CSeq: " << ++RtspCSeq << "\r\n";
     Msg << "\r\n";

     if(!SendRTSP(Sockfd, Msg.str())) {
         Close(Sockfd);
         return RTSP_SEND_ERROR;
     }
     if(!RecvRTSP(Sockfd, &RtspResponse)) {
         Close(Sockfd);
         return RTSP_RECV_ERROR;
     }
     return RTSP_NO_ERROR;
 }

第6-11行，获取RTSP的URI（如rtsp://127.0.0.1/ansersion）。先检查DoOPTIONS参数传入的URI，如果不存在就使用类成员变量RtspURI（更多说明见“实现篇（二）二、RtspClient::RtspClient(string uri)”），若RtspURI也不存在则返回失败。如果参数传入URI，该URI同时会保存至类成员变量RtspURI从而记忆住该URI，以便后续调用“DoXXX”RTSP命令函数时，不必再重复传入URI。

第13-14行，根据URI创建socket，用于和RTSP服务端通信（注：CreateTcpSockfd会根据URI中的IP创建socket，如果以前创建过socket且未关闭，则继续沿用旧有socket。截至版本1.2.3，仅支持使用IPv4的URI）。

第16-20行，组建OPTIONS报文（参见RFC2326 10.1）。

第22-25行，向服务端发送OPTIONS报文。

第26-29行，接收服务端返回报文，并将报文赋值给类成员变量RtspResponse（可以通过GetResponse()获取该值）。

第30行，返回成功。

二、ErrorType RtspClient::DoPLAY(MediaSession * media_session)

 ErrorType RtspClient::DoPLAY(MediaSession * media_session)
 {
     if(!media_session) {
         return RTSP_INVALID_MEDIA_SESSION;
     }

     ErrorType Err = RTSP_NO_ERROR;
     int Sockfd = -;
     Sockfd = CreateTcpSockfd();
     if(Sockfd < ) return RTSP_INVALID_URI;

     string Cmd("PLAY");
     stringstream Msg("");
     Msg << Cmd << " " << RtspURI << " " << "RTSP/" << VERSION_RTSP << "\r\n";
     Msg << "CSeq: " << ++RtspCSeq << "\r\n";
     Msg << "Session: " << media_session->SessionID << "\r\n";
     if(Realm.length() >  && Nonce.length() > ) {
         string RealmTmp = Realm;
         string NonceTmp = Nonce;
         string Md5Response  = MakeMd5DigestResp(RealmTmp, Cmd, RtspURI,  NonceTmp);
         if(Md5Response.length() != MD5_SIZE) {
             cout << "Make MD5 digest response error" << endl;
             return RTSP_RESPONSE_401;
         }
         Msg << "Authorization: Digest username=\"" << Username << "\", realm=\""
             << RealmTmp << "\", nonce=\"" << NonceTmp << "\", uri=\"" << RtspURI
             << "\", response=\"" << Md5Response << "\"\r\n";
     }
     Msg << "\r\n";

     if(RTSP_NO_ERROR == Err && !SendRTSP(Sockfd, Msg.str())) {
         Close(Sockfd);
         Sockfd = -;
         Err = RTSP_SEND_ERROR;
     }
     if(RTSP_NO_ERROR == Err && !RecvRTSP(Sockfd, &RtspResponse)) {
         Close(Sockfd);
         Sockfd = -;
         Err = RTSP_RECV_ERROR;
     }
     return RTSP_NO_ERROR;
 }

第3-5行，判断media_session是否有效（MediaSession类存有音频或视频相关信息，后续章节将做说明）。

第9-10行，创建socket。

第12-29行，组建PLAY报文（参见RFC2326 10.5），其中第17-28行在报文中加入鉴权信息（参见RFC2069），如果不需要鉴权则可略去。

第31-35行，向服务端发送PLAY报文。

第36-40行，接收服务端返回报文。

example代码中使用的是ErrorType RtspClient::DoPLAY(string media_type)，是该函数的封装，参数media_type取“video”或“audio”。

上一篇                       回目录                      下一篇