前言

智能貓眼是一種家居安防產(chǎn)品。是安裝在防盜門(mén)上的一種嵌入式設(shè)備，可以通過(guò)攝像頭獲取圖像顯示至手機(jī)應(yīng)用中，這樣老人或者小孩就可以看清門(mén)外的情況。

智能貓眼的實(shí)現(xiàn)是采用流媒體協(xié)議 RTSP。該協(xié)議定義了程序如何通過(guò) IP 網(wǎng)絡(luò)傳送多媒體數(shù)據(jù)。RTSP 多用于安防攝像頭、車載監(jiān)控、網(wǎng)絡(luò)直播等場(chǎng)景應(yīng)用。本文檔旨在講解在 OpenAtom OpenHarmony（以下簡(jiǎn)稱“OpenHarmony"） 1.0.1 release 下將 Hi3518EV300 編碼后的 H.265 視頻格式（H.265 是一種視頻編碼格式，可以由 OpenHarmony 媒體子系統(tǒng)產(chǎn)生），通過(guò) RTSP 傳輸顯示到手機(jī)的應(yīng)用中。

注：Hi3518EV300是 潤(rùn)和Hi3518 HiSpark IPC AI攝像頭開(kāi)發(fā)板套件

如上圖片：Hi3518EV300 設(shè)備將捕獲到的圖像通過(guò) RTSP 發(fā)送到手機(jī)應(yīng)用中并顯示出來(lái)。

開(kāi)發(fā)流程

RTSP 采用 Server/Client 模式，在本樣例場(chǎng)景中 Hi3518EV300為RTSP Server，手機(jī)應(yīng)用為 RTSP Client。在 RTSP 體系結(jié)構(gòu)包含 RTSP和RTP（實(shí)時(shí)傳輸協(xié)議）兩種協(xié)議，其中 RTSP 協(xié)議用于建立連接與傳輸多媒體控制命令（開(kāi)始、暫停、結(jié)束等），RTP 協(xié)議用來(lái)傳輸多媒體數(shù)據(jù)（音頻、視頻）。

RTSP Server 的實(shí)現(xiàn)分為如下幾步：

●設(shè)置 Wi-Fi：將手機(jī)與 Hi3518EV300 在同一網(wǎng)絡(luò)中；

●環(huán)形緩存區(qū)：將媒體子系統(tǒng)中編碼出的 H.265 數(shù)據(jù)存入環(huán)形緩存中；

●RTSP：RTSP Server 通過(guò) RTSP 與 RTSP Client 交互控制信息；

●RTP ：RTSP Server 收到PLAY命令后從環(huán)形緩存中獲取 H.265 數(shù)據(jù)并使用 RTP 協(xié)議發(fā)送。

如下圖所示：

如何運(yùn)行 RTSP Server 可以參考文章智能貓眼 3518 開(kāi)發(fā)樣例，下面根據(jù)該文章講解 RTSP Server 的實(shí)現(xiàn)流程。

代碼結(jié)構(gòu)：

├── smart_door_viewer_3518│   ├── BUILD.gn                                      // 編譯構(gòu)建│   ├── include│   │   ├── camera_sample.h                   // 攝像頭操作頭文件│   │   ├── rtp.h                                         // rtp協(xié)議傳輸頭文件│   │   ├── rtsp_log.h                                // 打印調(diào)試頭文件│   │   └── rtsp_server.h                           // rtsp頭文件│   └── src│       ├── camera_sample.cpp                 // 攝像頭實(shí)現(xiàn)│       ├── main.cpp                                   // 主函數(shù)│       ├── rtp.cpp                                       // rtp協(xié)議實(shí)現(xiàn)│       └── rtsp_server.cpp                         // rtsp協(xié)議實(shí)現(xiàn)├── foundation              │   └── multimedia│       └── media_lite│           ├── frameworks│           │   └── recorder_lite │           │       ├── recorder.cpp                //增加獲取攝像頭H.265數(shù)據(jù)實(shí)現(xiàn)類接口│           │       ├── recorder_impl.cpp       //增加獲取攝像頭H.265數(shù)據(jù)實(shí)現(xiàn)│           │       └── recorder_impl.h           //增加獲取攝像頭H.265數(shù)據(jù)實(shí)現(xiàn)定義│           └── interfaces│               └── kits│                   └── recorder_lite│└──recorder.h//增加應(yīng)用層獲取攝像頭H.265數(shù)據(jù)實(shí)現(xiàn)類接口定義

設(shè)置Wi-Fi

設(shè)置 Wi-Fi 連接熱點(diǎn) ssid 為“Smedia”psk為“12345678”。

在文件 wpa_supplicant.conf 中修改如下：

country=GBctrl_interface=udpnetwork={    ssid="SMedia"    psk="12345678"}

設(shè)備啟動(dòng)后輸入：

./bin/wpa_supplicant -iwlan0 -c/etc/wpa_supplicant.conf

輸入 ifconfig 可查看到連接成功后的 IP 地址：

環(huán)形緩存區(qū)

在媒體子系統(tǒng)中，為了同步 RTSP Server 應(yīng)用獲取 H.265 數(shù)據(jù)須設(shè)計(jì)一個(gè)環(huán)形緩沖區(qū)。緩沖區(qū)總大小為 16*256K 長(zhǎng)度的數(shù)組。put 為媒體子系統(tǒng)存放緩沖區(qū)的偏移值，get 為 RTSP Server（Hi3518EV300）線程獲取緩沖區(qū)的偏移值，緩存區(qū)定義在文件 recorder_impl.h 下。

constexpr uint32_t RING_BUFF_MAX_CNT = 16;constexpruint32_tRING_BUFF_SIZE=256*1024;

具體實(shí)現(xiàn)如下：

初始情況下偏移值 put 與 get 的位置均在開(kāi)頭。

當(dāng) RTSP Server 啟動(dòng)后媒體子系統(tǒng)填充 buff，偏移值 put 向前移。

RTSP Server 通過(guò)偏移值 get 獲取到視頻編碼數(shù)據(jù)后釋放 buff，偏移值 get 向前移。

當(dāng) put 與 get 偏移超過(guò) 16 時(shí)重新置 1 因此形象地稱為環(huán)形緩沖區(qū)，其中 get 永遠(yuǎn)在 put 后且間距不會(huì)超過(guò) 3 個(gè) buff，實(shí)現(xiàn)是在 rtsp Server 中設(shè)置同步時(shí)間。

代碼實(shí)現(xiàn)邏輯：當(dāng) RTSP Server 運(yùn)行到 RTP 時(shí)才會(huì)往緩沖區(qū)存放數(shù)據(jù)(ringStatus 標(biāo)志位設(shè)置為 true)。存入緩沖區(qū)的首幀是從關(guān)鍵幀（幀頭為 0x40 與 0x01 與 startFramFlag 標(biāo)志位為 true）開(kāi)始，后續(xù)所有幀都會(huì)保存到緩沖區(qū)中（saveFlag 標(biāo)志位設(shè)置為 true,startFramFlag 標(biāo)志位為 false），在函數(shù) VideoSourceProcess 下實(shí)現(xiàn)。

if ((iNumber < RING_BUFF_MAX_CNT) && (ringStatus == true)) {    if((startFramFlag == true) &&(buffer.dataAddr[4]==0x40)        && (buffer.dataAddr[5]==0x01)) {        if (memcpy_s(ringFifo[iPut].buffer, RING_BUFF_SIZE, buffer.dataAddr, buffer.dataLen) != EOK) {            MEDIA_INFO_LOG("[Error] memcpy_s");         } else {            ringFifo[iPut].size = buffer.dataLen;            iPut = addring(iPut);            iNumber++;            startFramFlag = false;            saveFlag = true;        }     } else {         if(saveFlag == true) {             if (memcpy_s(ringFifo[iPut].buffer, RING_BUFF_SIZE, buffer.dataAddr, buffer.dataLen) != EOK) {                MEDIA_INFO_LOG("[Error] memcpy_s");              } else {                 ringFifo[iPut].size = buffer.dataLen;                 iPut = addring(iPut);                 iNumber++;                       }          }      }}

RTSP

RTSP Server 與 RTSP Client 通過(guò) RTSP 協(xié)議收發(fā)控制命令，其基本流程如下：

●OPTION：首先 Client 連接到 Server 并發(fā)送 OPTION 命令，Server 立刻返回所支持的命令（OPTION、DESCRIBE、SETUP、PLAY、TEARDOWN）；

●DESCRIBE：Client 發(fā)送描述命令（DESCRIBE），Server 通過(guò)一個(gè) SDP 描述來(lái)進(jìn)行反饋，反饋信息包括流數(shù)量、媒體類型等信息；

●SETUP：Client 分析 SDP 描述，并為會(huì)話中發(fā)送建立命令(SETUP)，告訴 Server 用于接收媒體數(shù)據(jù)的端口；

●PLAY：連接建立完成后，Client 發(fā)送一個(gè)播放命令(PLAY)，Server 就開(kāi)始在 UDP 上傳送媒體流（RTP包）到 Client；

●TERADOWN：最后 Client 可發(fā)送一個(gè)終止命令(TERADOWN)來(lái)結(jié)束流媒體會(huì)話。

其交互流程如下所示：

在文件 rtsp_server.cpp 中，RTSP Server 收到 OPTION 后回復(fù)服務(wù)器提供的可用命令（OPTION、DESCRIBE、SETUP、PLAY、TEARDOWN）。

函數(shù)實(shí)現(xiàn)如下：

static void RtspOptions(char* sendBuff, RtspClientInfo &rtspCliInfo){    sprintf(sendBuff, "RTSP/1.0 200 OK
"                    "CSeq: %d
"                    "Public: OPTIONS, DESCRIBE, SETUP, PLAY, TEARDOWN
"                    "
",                    rtspCliInfo.rtspCseq);}

RTSP Server 收到 DESCRIBE 后回復(fù) SDP （SDP 信息為會(huì)話名稱和目的、會(huì)話持續(xù)時(shí)間、媒體類（音頻、視頻等）、傳輸協(xié)議（RTP/UDP/IP等）、媒體編碼格式（H.264、H.265 等）、接收媒體的相關(guān)信息端口和格式等。）信息。

函數(shù)實(shí)現(xiàn)如下：

static void RtspDescribe(char* sendBuff, RtspClientInfo &rtspCliInfo){    char sdp[512];
    memset(sdp, 0, sizeof(sdp));    sprintf(sdp, "v=0
"                 "o=- 973 1 IN IP4 192.168.1.103
"                 "t=0 0
"                 "a=control:*
"                 "m=video 0 RTP/AVP 96
"                 "a=rtpmap:96 H265/90000
"                 "a=control:track0

");    sprintf(sendBuff, "RTSP/1.0 200 OK
CSeq: %d
"                    "Content-Base: %s
"                    "Content-type: application/sdp
"                    "Content-length: %d

"                    "%s",                    rtspCliInfo.rtspCseq,                    "rtsp://192.168.1.127:8554/test.264",                    strlen(sdp),                    sdp);}

RTSP Server 收到 SETUP 后回復(fù)傳輸模式（采用 RTP 傳輸）、端口號(hào)信息準(zhǔn)備 play。

函數(shù)實(shí)現(xiàn)如下：

static void RtspStep(char* sendBuff, RtspClientInfo &rtspCliInfo){    sprintf(sendBuff,             "RTSP/1.0 200 OK
"            "CSeq: %d
"            "Transport: RTP/AVP;unicast;client_port=55532-55532;"            "server_port=%d-%d
"            "Session: 66334873
"            "
",            rtspCliInfo.rtspCseq, rtspCliInfo.clientPort, rtspCliInfo.clientPort + 1);}

RTSP Server 收到 PLAY 后回復(fù) Range 的值為"npt=0.0000-"，表示從開(kāi)始播放，默認(rèn)一直播放！隨后發(fā)送視頻流數(shù)據(jù)。

static void RtspPlay(char* sendBuff, RtspClientInfo &rtspCliInfo){    sprintf(sendBuff, "RTSP/1.0 200 OK
"                "CSeq: %d
"                "Range: npt=0.000-
"                "Session: 66334873; timeout=60

",                rtspCliInfo.rtspCseq);}

程序運(yùn)行后使用 wireshark 抓取報(bào)文如下：

RTP

RTSP 會(huì)話進(jìn)行到 PLAY 后就可啟動(dòng) RTP 發(fā)送視頻流數(shù)據(jù)，RTP 包分為 RtpHeader（Rtp 頭）加 payload(負(fù)載數(shù)據(jù))，在文件 rtp.cpp 下的 UdpSendFrame 函數(shù)中。

RtpHeader

●csrcLen csrc 計(jì)數(shù)，在沒(méi)有 RTP 混頻器的情況下通常為 0

●extension 擴(kuò)展名，必須為 0

●padding 填充位，不得使用填充，默認(rèn)為 0

●version 版本號(hào)為 2

●payloadType 數(shù)據(jù)幀類型 96（H.265）

●marker 將一幀分片時(shí)區(qū)分頭片

●seq 序列號(hào)為了以每片為單位

●timestamp 時(shí)間戳以每幀為單位

●ssrc 數(shù)據(jù)信源號(hào)

rtpPacket.rtpHeader.csrcLen = 0;rtpPacket.rtpHeader.extension = 0;rtpPacket.rtpHeader.padding = 0;rtpPacket.rtpHeader.version = 2;
rtpPacket.rtpHeader.payloadType = 96;
rtpPacket.rtpHeader.ssrc = 10;
rtpPacket.rtpHeader.timestamp = timestamp;timestamp+=90000/25;

payload

RTP 包最大為 1400 個(gè)字節(jié)，因此打包分為兩種：

1.若 H.265 幀小于 1400 個(gè)字節(jié)時(shí)可放至一個(gè) rtp 包中；

2.若 H.265 幀大于 1400 個(gè)字節(jié)時(shí)，則需要分片打包在多個(gè) rtp 中；

當(dāng)文件小于 1400 時(shí)直接放到 pyahload 中發(fā)送。

if (s32NalBufSize <= RTP_MAX_PKT_SIZE) {      if (memcpy_s(rtpPacket.payload, s32NalBufSize, pNalBuf, s32NalBufSize) != EOK){        SAMPLE_INFO("memcpy_s");    return -1;    }    rtpPacket.rtpHeader.marker   = 1;    rtpPacket.rtpHeader.seq = seq++;    ret = UdpSendPacket(&rtpPacket, s32NalBufSize);    sendBytes += ret;    SAMPLE_INFO("sendBytes->%d", sendBytes);}

若 H.265 幀大于 1400 個(gè)字節(jié)時(shí)就必須進(jìn)行分片封包處理。則要設(shè)置 PayloadHdr、FU（Fragmentation Units）、DONL 暫不涉及可以省略，其中 PayloadHdr 固定為 49。

   0                   1                   2                   3    0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+   |    PayloadHdr (Type=49)       |   FU header   | DONL (cond)   |   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-|   | DONL (cond)   |                                               |   |-+-+-+-+-+-+-+-+                                               ||FUpayload|

FUheader 格式為：S 置 1 表示起始片，E 置 1 表示最后片，F(xiàn)uType 就是實(shí)際的 Nal type 類型。

  +---------------+  |0|1|2|3|4|5|6|7|  +-+-+-+-+-+-+-+-+  |S|E|  FuType   |+---------------+

函數(shù)中實(shí)現(xiàn)如下：

int pktNum = s32NalBufSize / RTP_MAX_PKT_SIZE;         int remainPktSize = s32NalBufSize % RTP_MAX_PKT_SIZE;    int i, pos, head_len;    head_len = 2;    pos = head_len;     for(i = 0; i < pktNum; i++)    {      rtpPacket.rtpHeader.seq = seq++;            rtpPacket.payload[0] = 49 << 1;      rtpPacket.payload[1] = 1;      rtpPacket.payload[2] = (naluType & 0x7E)>>1;      if (i == 0) {         rtpPacket.rtpHeader.marker = 1;        rtpPacket.payload[2] |= 0x80; // start      }      else if (remainPktSize == 0 && i == (pktNum - 1)){        rtpPacket.rtpHeader.marker = 0;        rtpPacket.payload[2] |= 0x40; // end      }      if (memcpy_s(rtpPacket.payload + head_len + 1, RTP_MAX_PKT_SIZE, pNalBuf+pos, RTP_MAX_PKT_SIZE) != EOK) {        SAMPLE_INFO("memcpy_s");          return -1;      }            ret = UdpSendPacket(&rtpPacket, RTP_MAX_PKT_SIZE + head_len + 1);      if (ret < 0) {        SAMPLE_ERROR("rtpSendPacket is error");        goto cleanup;      }      sendBytes += ret;      pos += RTP_MAX_PKT_SIZE;    }    if (remainPktSize > 0)    {      {        rtpPacket.payload[0] = 49 << 1;        rtpPacket.payload[1] = 1;        rtpPacket.payload[2] = (naluType & 0x7E)>>1;        rtpPacket.payload[2] |= 0x40; // end      }      if (memcpy_s(rtpPacket.payload + head_len + 1, remainPktSize, pNalBuf+pos, remainPktSize) != EOK) {        SAMPLE_INFO("memcpy_s");          return -1;      }      rtpPacket.rtpHeader.seq = seq++;      ret = UdpSendPacket(&rtpPacket, remainPktSize+head_len+1);      if(ret < 0)      {        SAMPLE_ERROR("rtpSendPacket is error");        goto cleanup;      }      sendBytes += ret;    }

程序運(yùn)行后使用 wireshark 抓取報(bào)文如下：

RTSP Client

RTSP Client 實(shí)現(xiàn)使用手機(jī) APP”完美播放器“。

準(zhǔn)備一臺(tái)手機(jī)，在手機(jī)應(yīng)用市場(chǎng)中搜索”完美播放器“并下載安裝。

打開(kāi)菜單選擇網(wǎng)址播放。

輸入 rtsp 播放地址，其中 ip 地址 10.42.0.54為Hi3518EV300中Wi-Fi 的地址。

總結(jié)

豐富多樣的 OpenHarmony 開(kāi)發(fā)樣例離不開(kāi)廣大合作伙伴和開(kāi)發(fā)者的貢獻(xiàn)，如果你也想把自己開(kāi)發(fā)的樣例分享出來(lái)，歡迎把樣例提交到 OpenHarmony 知識(shí)體系 SIG 倉(cāng)來(lái)，共建開(kāi)發(fā)樣例請(qǐng)參考如何共建開(kāi)發(fā)樣例。

審核編輯 ：李倩