[TOC] ## 語法 ### 請求格式 與HTTP 語法基本相同 ``` COMMAND rtsp_URL RTSP/1.0<CRLF> Headerfield1: val1<CRLF> Headerfield2: val2<CRLF> ... <CRLF> [Body] ``` RTSP 消息行之間用回車換行 (CRLF) 分隔. 一個空行表示消息頭部分的結束。 語法說明 ``` rtsp_URL: 可使用如下格式,rtsp://<servername>/live.mp4[?<param>=<value>[&<param>=<value>...]] ``` #### 公用請求頭 | 頭字段 | 描述 | | --- | --- | | Authorization | 客戶端的認證信息. | | CSeq | 請求序列號. | | Session | 會話 ID (返回自服務端的 SETUP 應答). | | Content-Length | 內容的長度. | | Content-Type | 內容的媒體類型. | | User-Agent | 關于創建這個請求的客戶端的信息. | | Require | 查詢是否支持指定的選項，不支持的選項會在 Unsupported 頭中列出. | ### 響應語法 ``` RTSP/1.0 <Status Code> <Reason Phrase> <CRLF> Headerfield3: val3<CRLF> Headerfield4: val4<CRLF> ... <CRLF> [Body] ``` ### 公用響應請求頭 | 頭字段 | 描述 | | --- | --- | | CSeq | 應答序列號 (和請求序列匹配). | | Session | 會話 ID. | | WWW-Authenticate | 客戶端的認證信息. | | Date | 應答的日期和時間. | | Unsupported | 服務端不支持的特性和功能. | ## 全部方法 |方法|方向|對象|要求|含義| |---|---|---|---|---| |DESCRIBE|C->S|P,S|推薦|檢查演示或媒體對象的描述，也允許使用接收頭指定用戶理解的描述格式。DESCRIBE的答復-響應組成媒體RTSP初始階段| |ANNOUNCE|C->S S->C|P,S|可選|當從用戶發往服務器時，ANNOUNCE將請求URL識別的演示或媒體對象描述發送給服務器；反之，ANNOUNCE實時更新連接描述。如新媒體流加入演示，整個演示描述再次發送，而不僅僅是附加組件，使組件能被刪除| |GET_PARAMETER|C->S S->C|P,S|可選|GET_PARAMETER請求檢查RUL指定的演示與媒體的參數值。沒有實體體時，GET_PARAMETER也許能用來測試用戶與服務器的連通情況| |OPTIONS|C->S S->C|P,S|要求|可在任意時刻發出OPTIONS請求，如用戶打算嘗試非標準請求，并不影響服務器狀態| |PAUSE|C->S|P,S|推薦|PAUSE請求引起流發送臨時中斷。如請求URL命名一個流，僅回放和記錄被停止；如請求URL命名一個演示或流組，演示或組中所有當前活動的流發送都停止。恢復回放或記錄后，必須維持同步。在SETUP消息中連接頭超時參數所指定時段期間被暫停后，盡管服務器可能關閉連接并釋放資源，但服務器資源會被預訂| |PLAY|C->S|P,S|要求|PLAY告訴服務器以SETUP指定的機制開始發送數據；直到一些SETUP請求被成功響應，客戶端才可發布PLAY請求。PLAY請求將正常播放時間設置在所指定范圍的起始處，發送流數據直到范圍的結束處。PLAY請求可排成隊列，服務器將PLAY請求排成隊列，順序執行| |RECORD|C->S|P,S|可選|該方法根據演示描述初始化媒體數據記錄范圍，時標反映開始和結束時間；如沒有給出時間范圍，使用演示描述提供的開始和結束時間。如連接已經啟動，立即開始記錄，服務器數據請求URL或其他URL決定是否存儲記錄的數據；如服務器沒有使用URL請求，響應應為201（創建），并包含描述請求狀態和參考新資源的實體與位置頭。支持現場演示記錄的媒體服務器必須支持時鐘范圍格式，smpte格式沒有意義| |REDIRECT|S->C|P,S|可選|重定向請求通知客戶端連接到另一服務器地址。它包含強制頭地址，指示客戶端發布URL請求；也可能包括參數范圍，以指明重定向何時生效。若客戶端要繼續發送或接收URL媒體，客戶端必須對當前連接發送TEARDOWN請求，而對指定主執新連接發送SETUP請求| |SETUP|C->S|S|要求|對URL的SETUP請求指定用于流媒體的傳輸機制。客戶端對正播放的流發布一個SETUP請求，以改變服務器允許的傳輸參數。如不允許這樣做，響應錯誤為"455 Method Not Valid In This State”。為了透過防火墻，客戶端必須指明傳輸參數，即使對這些參數沒有影響| |SET_PARAMETER|C->S S->C|P,S|可選|請求設置演示或URL指定流的參數值。請求僅應包含單個參數，允許客戶端決定某個特殊請求為何失敗。如請求包含多個參數，所有參數可成功設置，服務器必須只對該請求起作用。服務器必須允許參數可重復設置成同一值，但不讓改變參數值。注意：媒體流傳輸參數必須用SETUP命令設置。將設置傳輸參數限制為SETUP有利于防火墻。將參數劃分成規則排列形式，結果有更多有意義的錯誤指示| |TEARDOWN|C->S|P,S|要求|TEARDOWN請求停止給定URL流發送，釋放相關資源。如URL是此演示URL，任何RTSP連接標識不再有效。除非全部傳輸參數是連接描述定義的，SETUP請求必須在連接可再次播放前發布| > 注：P---演示，C---客戶端,S---服務器，?S（對象欄）---流