rtmp.h 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425
  1. #ifndef __RTMP_H__
  2. #define __RTMP_H__
  3. /*
  4. * Copyright (C) 2005-2008 Team XBMC
  5. * http://www.xbmc.org
  6. * Copyright (C) 2008-2009 Andrej Stepanchuk
  7. * Copyright (C) 2009-2010 Howard Chu
  8. *
  9. * This file is part of librtmp.
  10. *
  11. * librtmp is free software; you can redistribute it and/or modify
  12. * it under the terms of the GNU Lesser General Public License as
  13. * published by the Free Software Foundation; either version 2.1,
  14. * or (at your option) any later version.
  15. *
  16. * librtmp is distributed in the hope that it will be useful,
  17. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  18. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  19. * GNU General Public License for more details.
  20. *
  21. * You should have received a copy of the GNU Lesser General Public License
  22. * along with librtmp see the file COPYING. If not, write to
  23. * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
  24. * Boston, MA 02110-1301, USA.
  25. * http://www.gnu.org/copyleft/lgpl.html
  26. */
  27. #define NO_CRYPTO 1
  28. #if !defined(NO_CRYPTO) && !defined(CRYPTO)
  29. #define CRYPTO
  30. #else
  31. #include <sys/types.h> //for off_t
  32. #endif
  33. #include <errno.h>
  34. #include <stdint.h>
  35. #ifdef _WIN32
  36. #ifdef _MSC_VER
  37. #pragma warning(disable:4996) //depricated warnings
  38. #pragma warning(disable:4244) //64bit defensive mechanism, fixed the ones that mattered
  39. #endif
  40. #include <winsock2.h>
  41. #include <ws2tcpip.h>
  42. #else
  43. #include <sys/socket.h>
  44. #include <netinet/in.h>
  45. #define SOCKET int
  46. #endif
  47. #include "amf.h"
  48. #ifdef __cplusplus
  49. extern "C"
  50. {
  51. #endif
  52. #define RTMP_LIB_VERSION 0x020300 /* 2.3 */
  53. #define RTMP_FEATURE_HTTP 0x01
  54. #define RTMP_FEATURE_ENC 0x02
  55. #define RTMP_FEATURE_SSL 0x04
  56. #define RTMP_FEATURE_MFP 0x08 /* not yet supported */
  57. #define RTMP_FEATURE_WRITE 0x10 /* publish, not play */
  58. #define RTMP_FEATURE_HTTP2 0x20 /* server-side rtmpt */
  59. #define RTMP_PROTOCOL_UNDEFINED -1
  60. #define RTMP_PROTOCOL_RTMP 0
  61. #define RTMP_PROTOCOL_RTMPE RTMP_FEATURE_ENC
  62. #define RTMP_PROTOCOL_RTMPT RTMP_FEATURE_HTTP
  63. #define RTMP_PROTOCOL_RTMPS RTMP_FEATURE_SSL
  64. #define RTMP_PROTOCOL_RTMPTE (RTMP_FEATURE_HTTP|RTMP_FEATURE_ENC)
  65. #define RTMP_PROTOCOL_RTMPTS (RTMP_FEATURE_HTTP|RTMP_FEATURE_SSL)
  66. #define RTMP_PROTOCOL_RTMFP RTMP_FEATURE_MFP
  67. #define RTMP_DEFAULT_CHUNKSIZE 128
  68. /* needs to fit largest number of bytes recv() may return */
  69. #define RTMP_BUFFER_CACHE_SIZE (16*1024)
  70. #define RTMP_CHANNELS 65600
  71. extern const char RTMPProtocolStringsLower[][7];
  72. extern const AVal RTMP_DefaultFlashVer;
  73. extern int RTMP_ctrlC;
  74. uint32_t RTMP_GetTime(void);
  75. /* RTMP_PACKET_TYPE_... 0x00 */
  76. #define RTMP_PACKET_TYPE_CHUNK_SIZE 0x01
  77. /* RTMP_PACKET_TYPE_... 0x02 */
  78. #define RTMP_PACKET_TYPE_BYTES_READ_REPORT 0x03
  79. #define RTMP_PACKET_TYPE_CONTROL 0x04
  80. #define RTMP_PACKET_TYPE_SERVER_BW 0x05
  81. #define RTMP_PACKET_TYPE_CLIENT_BW 0x06
  82. /* RTMP_PACKET_TYPE_... 0x07 */
  83. #define RTMP_PACKET_TYPE_AUDIO 0x08
  84. #define RTMP_PACKET_TYPE_VIDEO 0x09
  85. /* RTMP_PACKET_TYPE_... 0x0A */
  86. /* RTMP_PACKET_TYPE_... 0x0B */
  87. /* RTMP_PACKET_TYPE_... 0x0C */
  88. /* RTMP_PACKET_TYPE_... 0x0D */
  89. /* RTMP_PACKET_TYPE_... 0x0E */
  90. #define RTMP_PACKET_TYPE_FLEX_STREAM_SEND 0x0F
  91. #define RTMP_PACKET_TYPE_FLEX_SHARED_OBJECT 0x10
  92. #define RTMP_PACKET_TYPE_FLEX_MESSAGE 0x11
  93. #define RTMP_PACKET_TYPE_INFO 0x12
  94. #define RTMP_PACKET_TYPE_SHARED_OBJECT 0x13
  95. #define RTMP_PACKET_TYPE_INVOKE 0x14
  96. /* RTMP_PACKET_TYPE_... 0x15 */
  97. #define RTMP_PACKET_TYPE_FLASH_VIDEO 0x16
  98. #define RTMP_MAX_HEADER_SIZE 18
  99. #define RTMP_PACKET_SIZE_LARGE 0
  100. #define RTMP_PACKET_SIZE_MEDIUM 1
  101. #define RTMP_PACKET_SIZE_SMALL 2
  102. #define RTMP_PACKET_SIZE_MINIMUM 3
  103. typedef struct RTMPChunk
  104. {
  105. int c_headerSize;
  106. int c_chunkSize;
  107. char *c_chunk;
  108. char c_header[RTMP_MAX_HEADER_SIZE];
  109. } RTMPChunk;
  110. typedef struct RTMPPacket
  111. {
  112. uint8_t m_headerType;
  113. uint8_t m_packetType;
  114. uint8_t m_hasAbsTimestamp; /* timestamp absolute or relative? */
  115. int m_nChannel;
  116. uint32_t m_nTimeStamp; /* timestamp */
  117. int32_t m_nInfoField2; /* last 4 bytes in a long header */
  118. uint32_t m_nBodySize;
  119. uint32_t m_nBytesRead;
  120. RTMPChunk *m_chunk;
  121. char *m_body;
  122. } RTMPPacket;
  123. typedef struct RTMPSockBuf
  124. {
  125. SOCKET sb_socket;
  126. int sb_size; /* number of unprocessed bytes in buffer */
  127. char *sb_start; /* pointer into sb_pBuffer of next byte to process */
  128. char sb_buf[RTMP_BUFFER_CACHE_SIZE]; /* data read from socket */
  129. int sb_timedout;
  130. void *sb_ssl;
  131. } RTMPSockBuf;
  132. void RTMPPacket_Reset(RTMPPacket *p);
  133. void RTMPPacket_Dump(RTMPPacket *p);
  134. int RTMPPacket_Alloc(RTMPPacket *p, int nSize);
  135. void RTMPPacket_Free(RTMPPacket *p);
  136. #define RTMPPacket_IsReady(a) ((a)->m_nBytesRead == (a)->m_nBodySize)
  137. typedef struct RTMP_Stream {
  138. int id;
  139. AVal playpath;
  140. } RTMP_Stream;
  141. typedef struct RTMP_LNK
  142. {
  143. #define RTMP_MAX_STREAMS 8
  144. RTMP_Stream streams[RTMP_MAX_STREAMS];
  145. int nStreams;
  146. int curStreamIdx;
  147. int playingStreams;
  148. AVal hostname;
  149. AVal sockshost;
  150. AVal tcUrl;
  151. AVal swfUrl;
  152. AVal pageUrl;
  153. AVal app;
  154. AVal auth;
  155. AVal flashVer;
  156. AVal subscribepath;
  157. AVal usherToken;
  158. AVal token;
  159. AVal pubUser;
  160. AVal pubPasswd;
  161. AMFObject extras;
  162. int edepth;
  163. int seekTime;
  164. int stopTime;
  165. #define RTMP_LF_AUTH 0x0001 /* using auth param */
  166. #define RTMP_LF_LIVE 0x0002 /* stream is live */
  167. #define RTMP_LF_SWFV 0x0004 /* do SWF verification */
  168. #define RTMP_LF_PLST 0x0008 /* send playlist before play */
  169. #define RTMP_LF_BUFX 0x0010 /* toggle stream on BufferEmpty msg */
  170. #define RTMP_LF_FTCU 0x0020 /* free tcUrl on close */
  171. int lFlags;
  172. int swfAge;
  173. int protocol;
  174. int timeout; /* connection timeout in seconds */
  175. #define RTMP_PUB_NAME 0x0001 /* send login to server */
  176. #define RTMP_PUB_RESP 0x0002 /* send salted password hash */
  177. #define RTMP_PUB_ALLOC 0x0004 /* allocated data for new tcUrl & app */
  178. #define RTMP_PUB_CLEAN 0x0008 /* need to free allocated data for newer tcUrl & app at exit */
  179. #define RTMP_PUB_CLATE 0x0010 /* late clean tcUrl & app at exit */
  180. int pFlags;
  181. unsigned short socksport;
  182. unsigned short port;
  183. #ifdef CRYPTO
  184. #define RTMP_SWF_HASHLEN 32
  185. void *dh; /* for encryption */
  186. void *rc4keyIn;
  187. void *rc4keyOut;
  188. uint32_t SWFSize;
  189. uint8_t SWFHash[RTMP_SWF_HASHLEN];
  190. char SWFVerificationResponse[RTMP_SWF_HASHLEN+10];
  191. #endif
  192. } RTMP_LNK;
  193. /* state for read() wrapper */
  194. typedef struct RTMP_READ
  195. {
  196. char *buf;
  197. char *bufpos;
  198. unsigned int buflen;
  199. uint32_t timestamp;
  200. uint8_t dataType;
  201. uint8_t flags;
  202. #define RTMP_READ_HEADER 0x01
  203. #define RTMP_READ_RESUME 0x02
  204. #define RTMP_READ_NO_IGNORE 0x04
  205. #define RTMP_READ_GOTKF 0x08
  206. #define RTMP_READ_GOTFLVK 0x10
  207. #define RTMP_READ_SEEKING 0x20
  208. int8_t status;
  209. #define RTMP_READ_COMPLETE -3
  210. #define RTMP_READ_ERROR -2
  211. #define RTMP_READ_EOF -1
  212. #define RTMP_READ_IGNORE 0
  213. /* if bResume == TRUE */
  214. uint8_t initialFrameType;
  215. uint32_t nResumeTS;
  216. char *metaHeader;
  217. char *initialFrame;
  218. uint32_t nMetaHeaderSize;
  219. uint32_t nInitialFrameSize;
  220. uint32_t nIgnoredFrameCounter;
  221. uint32_t nIgnoredFlvFrameCounter;
  222. } RTMP_READ;
  223. typedef struct RTMP_METHOD
  224. {
  225. AVal name;
  226. int num;
  227. } RTMP_METHOD;
  228. typedef struct RTMP_BINDINFO
  229. {
  230. struct sockaddr_storage addr;
  231. int addrLen;
  232. } RTMP_BINDINFO;
  233. typedef int (*CUSTOMSEND)(RTMPSockBuf*, const char *, int, void*);
  234. typedef struct RTMP
  235. {
  236. int m_inChunkSize;
  237. int m_outChunkSize;
  238. int m_nBWCheckCounter;
  239. int m_nBytesIn;
  240. int m_nBytesInSent;
  241. int m_nBufferMS;
  242. int m_stream_id; /* returned in _result from createStream */
  243. int m_mediaChannel;
  244. uint32_t m_mediaStamp;
  245. uint32_t m_pauseStamp;
  246. int m_pausing;
  247. int m_nServerBW;
  248. int m_nClientBW;
  249. uint8_t m_nClientBW2;
  250. uint8_t m_bPlaying;
  251. uint8_t m_bSendEncoding;
  252. uint8_t m_bSendCounter;
  253. uint8_t m_bUseNagle;
  254. uint8_t m_bCustomSend;
  255. void* m_customSendParam;
  256. CUSTOMSEND m_customSendFunc;
  257. RTMP_BINDINFO m_bindIP;
  258. uint8_t m_bSendChunkSizeInfo;
  259. int m_numInvokes;
  260. int m_numCalls;
  261. RTMP_METHOD *m_methodCalls; /* remote method calls queue */
  262. int m_channelsAllocatedIn;
  263. int m_channelsAllocatedOut;
  264. RTMPPacket **m_vecChannelsIn;
  265. RTMPPacket **m_vecChannelsOut;
  266. int *m_channelTimestamp; /* abs timestamp of last packet */
  267. double m_fAudioCodecs; /* audioCodecs for the connect packet */
  268. double m_fVideoCodecs; /* videoCodecs for the connect packet */
  269. double m_fEncoding; /* AMF0 or AMF3 */
  270. double m_fDuration; /* duration of stream in seconds */
  271. int m_msgCounter; /* RTMPT stuff */
  272. int m_polling;
  273. int m_resplen;
  274. int m_unackd;
  275. AVal m_clientID;
  276. RTMP_READ m_read;
  277. RTMPPacket m_write;
  278. RTMPSockBuf m_sb;
  279. RTMP_LNK Link;
  280. } RTMP;
  281. int RTMP_ParseURL(const char *url, int *protocol, AVal *host,
  282. unsigned int *port, AVal *app);
  283. void RTMP_ParsePlaypath(AVal *in, AVal *out);
  284. void RTMP_SetBufferMS(RTMP *r, int size);
  285. void RTMP_UpdateBufferMS(RTMP *r);
  286. int RTMP_SetOpt(RTMP *r, const AVal *opt, AVal *arg);
  287. int RTMP_SetupURL(RTMP *r, char *url);
  288. int RTMP_AddStream(RTMP *r, const char *playpath);
  289. void RTMP_SetupStream(RTMP *r, int protocol,
  290. AVal *hostname,
  291. unsigned int port,
  292. AVal *sockshost,
  293. AVal *playpath,
  294. AVal *tcUrl,
  295. AVal *swfUrl,
  296. AVal *pageUrl,
  297. AVal *app,
  298. AVal *auth,
  299. AVal *swfSHA256Hash,
  300. uint32_t swfSize,
  301. AVal *flashVer,
  302. AVal *subscribepath,
  303. AVal *usherToken,
  304. int dStart,
  305. int dStop, int bLiveStream, long int timeout);
  306. int RTMP_Connect(RTMP *r, RTMPPacket *cp);
  307. struct sockaddr;
  308. int RTMP_Connect0(RTMP *r, struct sockaddr *svc, socklen_t addrlen);
  309. int RTMP_Connect1(RTMP *r, RTMPPacket *cp);
  310. int RTMP_Serve(RTMP *r);
  311. int RTMP_TLS_Accept(RTMP *r, void *ctx);
  312. int RTMP_ReadPacket(RTMP *r, RTMPPacket *packet);
  313. int RTMP_SendPacket(RTMP *r, RTMPPacket *packet, int queue);
  314. int RTMP_SendChunk(RTMP *r, RTMPChunk *chunk);
  315. int RTMP_IsConnected(RTMP *r);
  316. SOCKET RTMP_Socket(RTMP *r);
  317. int RTMP_IsTimedout(RTMP *r);
  318. double RTMP_GetDuration(RTMP *r);
  319. int RTMP_ToggleStream(RTMP *r);
  320. int RTMP_ConnectStream(RTMP *r, int seekTime);
  321. int RTMP_ReconnectStream(RTMP *r, int seekTime, int streamIdx);
  322. void RTMP_DeleteStream(RTMP *r, int streamIdx);
  323. int RTMP_GetNextMediaPacket(RTMP *r, RTMPPacket *packet);
  324. int RTMP_ClientPacket(RTMP *r, RTMPPacket *packet);
  325. void RTMP_Init(RTMP *r);
  326. void RTMP_Close(RTMP *r);
  327. RTMP *RTMP_Alloc(void);
  328. void RTMP_Free(RTMP *r);
  329. void RTMP_EnableWrite(RTMP *r);
  330. void *RTMP_TLS_AllocServerContext(const char* cert, const char* key);
  331. void RTMP_TLS_FreeServerContext(void *ctx);
  332. int RTMP_LibVersion(void);
  333. void RTMP_UserInterrupt(void); /* user typed Ctrl-C */
  334. int RTMP_SendCtrl(RTMP *r, short nType, unsigned int nObject,
  335. unsigned int nTime);
  336. /* caller probably doesn't know current timestamp, should
  337. * just use RTMP_Pause instead
  338. */
  339. int RTMP_SendPause(RTMP *r, int DoPause, int dTime);
  340. int RTMP_Pause(RTMP *r, int DoPause);
  341. int RTMP_FindFirstMatchingProperty(AMFObject *obj, const AVal *name,
  342. AMFObjectProperty * p);
  343. int RTMPSockBuf_Fill(RTMPSockBuf *sb);
  344. int RTMPSockBuf_Send(RTMPSockBuf *sb, const char *buf, int len);
  345. int RTMPSockBuf_Close(RTMPSockBuf *sb);
  346. int RTMP_SendCreateStream(RTMP *r);
  347. int RTMP_SendSeek(RTMP *r, int dTime);
  348. int RTMP_SendServerBW(RTMP *r);
  349. int RTMP_SendClientBW(RTMP *r);
  350. void RTMP_DropRequest(RTMP *r, int i, int freeit);
  351. int RTMP_Read(RTMP *r, char *buf, int size);
  352. int RTMP_Write(RTMP *r, const char *buf, int size, int streamIdx);
  353. /* hashswf.c */
  354. int RTMP_HashSWF(const char *url, unsigned int *size, unsigned char *hash,
  355. int age);
  356. #ifdef __cplusplus
  357. };
  358. #endif
  359. #endif