rtmp.h 13 KB

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