FFmpeg
|
RTMP protocol. More...
#include "libavcodec/bytestream.h"
#include "libavutil/avstring.h"
#include "libavutil/base64.h"
#include "libavutil/hmac.h"
#include "libavutil/intfloat.h"
#include "libavutil/lfg.h"
#include "libavutil/md5.h"
#include "libavutil/opt.h"
#include "libavutil/random_seed.h"
#include "avformat.h"
#include "internal.h"
#include "network.h"
#include "flv.h"
#include "rtmp.h"
#include "rtmpcrypt.h"
#include "rtmppkt.h"
#include "url.h"
Go to the source code of this file.
Data Structures | |
struct | TrackedMethod |
struct | RTMPContext |
protocol handler context More... | |
Macros | |
#define | APP_MAX_LENGTH 1024 |
#define | PLAYPATH_MAX_LENGTH 512 |
#define | TCURL_MAX_LENGTH 1024 |
#define | FLASHVER_MAX_LENGTH 64 |
#define | RTMP_PKTDATA_DEFAULT_SIZE 4096 |
#define | RTMP_HEADER 11 |
#define | PLAYER_KEY_OPEN_PART_LEN 30 |
length of partial key used for first client digest signing More... | |
#define | SERVER_KEY_OPEN_PART_LEN 36 |
length of partial key used for first server digest signing More... | |
#define | OFFSET(x) offsetof(RTMPContext, x) |
#define | DEC AV_OPT_FLAG_DECODING_PARAM |
#define | ENC AV_OPT_FLAG_ENCODING_PARAM |
#define | RTMP_PROTOCOL(flavor) |
Enumerations | |
enum | ClientState { STATE_START, STATE_HANDSHAKED, STATE_FCPUBLISH, STATE_PLAYING, STATE_SEEKING, STATE_PUBLISHING, STATE_RECEIVING, STATE_SENDING, STATE_STOPPED } |
RTMP protocol handler state. More... | |
Functions | |
static int | handle_chunk_size (URLContext *s, RTMPPacket *pkt) |
static int | add_tracked_method (RTMPContext *rt, const char *name, int id) |
static void | del_tracked_method (RTMPContext *rt, int index) |
static int | find_tracked_method (URLContext *s, RTMPPacket *pkt, int offset, char **tracked_method) |
static void | free_tracked_methods (RTMPContext *rt) |
static int | rtmp_send_packet (RTMPContext *rt, RTMPPacket *pkt, int track) |
static int | rtmp_write_amf_data (URLContext *s, char *param, uint8_t **p) |
static int | gen_connect (URLContext *s, RTMPContext *rt) |
Generate 'connect' call and send it to the server. More... | |
static int | read_connect (URLContext *s, RTMPContext *rt) |
static int | gen_release_stream (URLContext *s, RTMPContext *rt) |
Generate 'releaseStream' call and send it to the server. More... | |
static int | gen_fcpublish_stream (URLContext *s, RTMPContext *rt) |
Generate 'FCPublish' call and send it to the server. More... | |
static int | gen_fcunpublish_stream (URLContext *s, RTMPContext *rt) |
Generate 'FCUnpublish' call and send it to the server. More... | |
static int | gen_create_stream (URLContext *s, RTMPContext *rt) |
Generate 'createStream' call and send it to the server. More... | |
static int | gen_delete_stream (URLContext *s, RTMPContext *rt) |
Generate 'deleteStream' call and send it to the server. More... | |
static int | gen_get_stream_length (URLContext *s, RTMPContext *rt) |
Generate 'getStreamLength' call and send it to the server. More... | |
static int | gen_buffer_time (URLContext *s, RTMPContext *rt) |
Generate client buffer time and send it to the server. More... | |
static int | gen_play (URLContext *s, RTMPContext *rt) |
Generate 'play' call and send it to the server, then ping the server to start actual playing. More... | |
static int | gen_seek (URLContext *s, RTMPContext *rt, int64_t timestamp) |
static int | gen_pause (URLContext *s, RTMPContext *rt, int pause, uint32_t timestamp) |
Generate a pause packet that either pauses or unpauses the current stream. More... | |
static int | gen_publish (URLContext *s, RTMPContext *rt) |
Generate 'publish' call and send it to the server. More... | |
static int | gen_pong (URLContext *s, RTMPContext *rt, RTMPPacket *ppkt) |
Generate ping reply and send it to the server. More... | |
static int | gen_swf_verification (URLContext *s, RTMPContext *rt) |
Generate SWF verification message and send it to the server. More... | |
static int | gen_server_bw (URLContext *s, RTMPContext *rt) |
Generate server bandwidth message and send it to the server. More... | |
static int | gen_check_bw (URLContext *s, RTMPContext *rt) |
Generate check bandwidth message and send it to the server. More... | |
static int | gen_bytes_read (URLContext *s, RTMPContext *rt, uint32_t ts) |
Generate report on bytes read so far and send it to the server. More... | |
static int | gen_fcsubscribe_stream (URLContext *s, RTMPContext *rt, const char *subscribe) |
int | ff_rtmp_calc_digest (const uint8_t *src, int len, int gap, const uint8_t *key, int keylen, uint8_t *dst) |
Calculate HMAC-SHA2 digest for RTMP handshake packets. More... | |
int | ff_rtmp_calc_digest_pos (const uint8_t *buf, int off, int mod_val, int add_val) |
Calculate digest position for RTMP handshake packets. More... | |
static int | rtmp_handshake_imprint_with_digest (uint8_t *buf, int encrypted) |
Put HMAC-SHA2 digest of packet data (except for the bytes where this digest will be stored) into that packet. More... | |
static int | rtmp_validate_digest (uint8_t *buf, int off) |
Verify that the received server response has the expected digest value. More... | |
static int | rtmp_calc_swf_verification (URLContext *s, RTMPContext *rt, uint8_t *buf) |
static int | rtmp_calc_swfhash (URLContext *s) |
static int | rtmp_handshake (URLContext *s, RTMPContext *rt) |
Perform handshake with the server by means of exchanging pseudorandom data signed with HMAC-SHA2 digest. More... | |
static int | rtmp_receive_hs_packet (RTMPContext *rt, uint32_t *first_int, uint32_t *second_int, char *arraydata, int size) |
static int | rtmp_send_hs_packet (RTMPContext *rt, uint32_t first_int, uint32_t second_int, char *arraydata, int size) |
static int | rtmp_server_handshake (URLContext *s, RTMPContext *rt) |
rtmp handshake server side More... | |
static int | handle_ping (URLContext *s, RTMPPacket *pkt) |
static int | handle_client_bw (URLContext *s, RTMPPacket *pkt) |
static int | handle_server_bw (URLContext *s, RTMPPacket *pkt) |
static int | do_adobe_auth (RTMPContext *rt, const char *user, const char *salt, const char *opaque, const char *challenge) |
static int | do_llnw_auth (RTMPContext *rt, const char *user, const char *nonce) |
static int | handle_connect_error (URLContext *s, const char *desc) |
static int | handle_invoke_error (URLContext *s, RTMPPacket *pkt) |
static int | write_begin (URLContext *s) |
static int | write_status (URLContext *s, RTMPPacket *pkt, const char *status, const char *filename) |
static int | send_invoke_response (URLContext *s, RTMPPacket *pkt) |
static int | read_number_result (RTMPPacket *pkt, double *number) |
Read the AMF_NUMBER response ("_result") to a function call (e.g. More... | |
static int | handle_invoke_result (URLContext *s, RTMPPacket *pkt) |
static int | handle_invoke_status (URLContext *s, RTMPPacket *pkt) |
static int | handle_invoke (URLContext *s, RTMPPacket *pkt) |
static int | update_offset (RTMPContext *rt, int size) |
static int | append_flv_data (RTMPContext *rt, RTMPPacket *pkt, int skip) |
static int | handle_notify (URLContext *s, RTMPPacket *pkt) |
static int | rtmp_parse_result (URLContext *s, RTMPContext *rt, RTMPPacket *pkt) |
Parse received packet and possibly perform some action depending on the packet contents. More... | |
static int | handle_metadata (RTMPContext *rt, RTMPPacket *pkt) |
static int | get_packet (URLContext *s, int for_header) |
Interact with the server by receiving and sending RTMP packets until there is some significant data (media data or expected status notification). More... | |
static int | rtmp_close (URLContext *h) |
static int | inject_fake_duration_metadata (RTMPContext *rt) |
Insert a fake onMetadata packet into the FLV stream to notify the FLV demuxer about the duration of the stream. More... | |
static int | rtmp_open (URLContext *s, const char *uri, int flags) |
Open RTMP connection and verify that the stream can be played. More... | |
static int | rtmp_read (URLContext *s, uint8_t *buf, int size) |
static int64_t | rtmp_seek (URLContext *s, int stream_index, int64_t timestamp, int flags) |
static int | rtmp_pause (URLContext *s, int pause) |
static int | rtmp_write (URLContext *s, const uint8_t *buf, int size) |
Variables | |
static const uint8_t | rtmp_player_key [] |
Client key used for digest signing. More... | |
static const uint8_t | rtmp_server_key [] |
Key used for RTMP server digest signing. More... | |
static const AVOption | rtmp_options [] |
RTMP protocol.
Definition in file rtmpproto.c.
#define APP_MAX_LENGTH 1024 |
Definition at line 51 of file rtmpproto.c.
Referenced by gen_connect(), and rtmp_open().
#define PLAYPATH_MAX_LENGTH 512 |
Definition at line 52 of file rtmpproto.c.
Referenced by rtmp_open().
#define TCURL_MAX_LENGTH 1024 |
Definition at line 53 of file rtmpproto.c.
Referenced by rtmp_open().
#define FLASHVER_MAX_LENGTH 64 |
Definition at line 54 of file rtmpproto.c.
Referenced by rtmp_open().
#define RTMP_PKTDATA_DEFAULT_SIZE 4096 |
Definition at line 55 of file rtmpproto.c.
Referenced by read_connect(), send_invoke_response(), and write_status().
#define RTMP_HEADER 11 |
Definition at line 56 of file rtmpproto.c.
Referenced by append_flv_data(), handle_invoke_status(), handle_metadata(), inject_fake_duration_metadata(), and rtmp_write().
#define PLAYER_KEY_OPEN_PART_LEN 30 |
length of partial key used for first client digest signing
Definition at line 135 of file rtmpproto.c.
Referenced by rtmp_handshake_imprint_with_digest().
#define SERVER_KEY_OPEN_PART_LEN 36 |
length of partial key used for first server digest signing
Definition at line 146 of file rtmpproto.c.
Referenced by rtmp_validate_digest().
#define OFFSET | ( | x | ) | offsetof(RTMPContext, x) |
Definition at line 3077 of file rtmpproto.c.
#define DEC AV_OPT_FLAG_DECODING_PARAM |
Definition at line 3078 of file rtmpproto.c.
#define ENC AV_OPT_FLAG_ENCODING_PARAM |
Definition at line 3079 of file rtmpproto.c.
#define RTMP_PROTOCOL | ( | flavor | ) |
Definition at line 3105 of file rtmpproto.c.
enum ClientState |
RTMP protocol handler state.
Definition at line 59 of file rtmpproto.c.
|
static |
Definition at line 1490 of file rtmpproto.c.
Referenced by read_connect(), and rtmp_parse_result().
|
static |
Definition at line 160 of file rtmpproto.c.
Referenced by rtmp_send_packet().
|
static |
Definition at line 183 of file rtmpproto.c.
Referenced by find_tracked_method().
|
static |
Definition at line 190 of file rtmpproto.c.
Referenced by handle_invoke_error(), and handle_invoke_result().
|
static |
Definition at line 215 of file rtmpproto.c.
Referenced by rtmp_close(), and rtmp_open().
|
static |
Definition at line 226 of file rtmpproto.c.
Referenced by gen_buffer_time(), gen_bytes_read(), gen_check_bw(), gen_connect(), gen_create_stream(), gen_delete_stream(), gen_fcpublish_stream(), gen_fcsubscribe_stream(), gen_fcunpublish_stream(), gen_get_stream_length(), gen_pause(), gen_play(), gen_pong(), gen_publish(), gen_release_stream(), gen_seek(), gen_server_bw(), gen_swf_verification(), and rtmp_write().
|
static |
Definition at line 254 of file rtmpproto.c.
Referenced by gen_connect().
|
static |
Generate 'connect' call and send it to the server.
Definition at line 317 of file rtmpproto.c.
Referenced by rtmp_open().
|
static |
Definition at line 402 of file rtmpproto.c.
Referenced by rtmp_open().
|
static |
Generate 'releaseStream' call and send it to the server.
It should make the server release some channel for media streams.
Definition at line 562 of file rtmpproto.c.
Referenced by handle_invoke_result().
|
static |
Generate 'FCPublish' call and send it to the server.
It should make the server prepare for receiving media streams.
Definition at line 586 of file rtmpproto.c.
Referenced by handle_invoke_result().
|
static |
Generate 'FCUnpublish' call and send it to the server.
It should make the server destroy stream.
Definition at line 610 of file rtmpproto.c.
Referenced by rtmp_close().
|
static |
Generate 'createStream' call and send it to the server.
It should make the server allocate some channel for media streams.
Definition at line 634 of file rtmpproto.c.
Referenced by handle_invoke_result().
|
static |
Generate 'deleteStream' call and send it to the server.
It should make the server remove some channel for media streams.
Definition at line 659 of file rtmpproto.c.
Referenced by rtmp_close().
|
static |
Generate 'getStreamLength' call and send it to the server.
If the server knows the duration of the selected stream, it will reply with the duration in seconds.
Definition at line 685 of file rtmpproto.c.
Referenced by handle_invoke_result().
|
static |
Generate client buffer time and send it to the server.
Definition at line 707 of file rtmpproto.c.
Referenced by handle_invoke_result().
|
static |
Generate 'play' call and send it to the server, then ping the server to start actual playing.
Definition at line 729 of file rtmpproto.c.
Referenced by handle_invoke_result().
|
static |
Definition at line 753 of file rtmpproto.c.
Referenced by rtmp_seek().
|
static |
Generate a pause packet that either pauses or unpauses the current stream.
Definition at line 779 of file rtmpproto.c.
Referenced by rtmp_pause().
|
static |
Generate 'publish' call and send it to the server.
Definition at line 806 of file rtmpproto.c.
Referenced by handle_invoke_result().
|
static |
Generate ping reply and send it to the server.
Definition at line 833 of file rtmpproto.c.
Referenced by handle_ping().
|
static |
Generate SWF verification message and send it to the server.
Definition at line 859 of file rtmpproto.c.
Referenced by handle_ping().
|
static |
Generate server bandwidth message and send it to the server.
Definition at line 880 of file rtmpproto.c.
Referenced by handle_invoke_result().
|
static |
Generate check bandwidth message and send it to the server.
Definition at line 899 of file rtmpproto.c.
Referenced by handle_invoke().
|
static |
Generate report on bytes read so far and send it to the server.
Definition at line 920 of file rtmpproto.c.
Referenced by get_packet().
|
static |
Definition at line 936 of file rtmpproto.c.
Referenced by handle_invoke_result().
int ff_rtmp_calc_digest | ( | const uint8_t * | src, |
int | len, | ||
int | gap, | ||
const uint8_t * | key, | ||
int | keylen, | ||
uint8_t * | dst | ||
) |
Calculate HMAC-SHA2 digest for RTMP handshake packets.
src | input buffer |
len | input buffer length (should be 1536) |
gap | offset in buffer where 32 bytes should not be taken into account when calculating digest (since it will be used to store that digest) |
key | digest key |
keylen | digest key length |
dst | buffer where calculated digest will be stored (32 bytes) |
Definition at line 956 of file rtmpproto.c.
Referenced by ff_rtmpe_compute_secret_key(), rtmp_calc_swf_verification(), rtmp_calc_swfhash(), rtmp_handshake(), rtmp_handshake_imprint_with_digest(), and rtmp_validate_digest().
int ff_rtmp_calc_digest_pos | ( | const uint8_t * | buf, |
int | off, | ||
int | mod_val, | ||
int | add_val | ||
) |
Calculate digest position for RTMP handshake packets.
buf | input buffer (should be 1536 bytes) |
off | offset in buffer where to start calculating digest position |
mod_val | value used for computing modulo |
add_val | value added at the end (after computing modulo) |
Definition at line 979 of file rtmpproto.c.
Referenced by ff_rtmpe_compute_secret_key(), ff_rtmpe_gen_pub_key(), rtmp_handshake_imprint_with_digest(), and rtmp_validate_digest().
|
static |
Put HMAC-SHA2 digest of packet data (except for the bytes where this digest will be stored) into that packet.
buf | handshake data (1536 bytes) |
encrypted | use an encrypted connection (RTMPE) |
Definition at line 999 of file rtmpproto.c.
Referenced by rtmp_handshake().
|
static |
Verify that the received server response has the expected digest value.
buf | handshake data received from the server (1536 bytes) |
off | position to search digest offset from |
Definition at line 1024 of file rtmpproto.c.
Referenced by rtmp_handshake().
|
static |
Definition at line 1042 of file rtmpproto.c.
Referenced by rtmp_handshake().
|
static |
Definition at line 1110 of file rtmpproto.c.
Referenced by rtmp_open().
|
static |
Perform handshake with the server by means of exchanging pseudorandom data signed with HMAC-SHA2 digest.
Definition at line 1196 of file rtmpproto.c.
Referenced by rtmp_open().
|
static |
Definition at line 1375 of file rtmpproto.c.
Referenced by rtmp_server_handshake().
|
static |
Definition at line 1396 of file rtmpproto.c.
Referenced by rtmp_server_handshake().
|
static |
|
static |
Definition at line 1523 of file rtmpproto.c.
Referenced by rtmp_parse_result().
|
static |
Definition at line 1550 of file rtmpproto.c.
Referenced by rtmp_parse_result().
|
static |
Definition at line 1574 of file rtmpproto.c.
Referenced by rtmp_parse_result().
|
static |
Definition at line 1596 of file rtmpproto.c.
Referenced by handle_connect_error().
|
static |
Definition at line 1635 of file rtmpproto.c.
Referenced by handle_connect_error().
|
static |
Definition at line 1694 of file rtmpproto.c.
Referenced by handle_invoke_error().
|
static |
Definition at line 1785 of file rtmpproto.c.
Referenced by handle_invoke().
|
static |
Definition at line 1824 of file rtmpproto.c.
Referenced by send_invoke_response().
|
static |
Definition at line 1850 of file rtmpproto.c.
Referenced by send_invoke_response().
|
static |
Definition at line 1896 of file rtmpproto.c.
Referenced by handle_invoke().
|
static |
Read the AMF_NUMBER response ("_result") to a function call (e.g.
createStream()). This response should be made up of the AMF_STRING "result", a NULL object and then the response encoded as AMF_NUMBER. On a successful response, we will return set the value to number (otherwise number will not be changed).
Definition at line 2005 of file rtmpproto.c.
Referenced by handle_invoke_result().
|
static |
Definition at line 2035 of file rtmpproto.c.
Referenced by handle_invoke().
|
static |
Definition at line 2107 of file rtmpproto.c.
Referenced by handle_invoke().
|
static |
Definition at line 2144 of file rtmpproto.c.
Referenced by rtmp_parse_result().
|
static |
Definition at line 2175 of file rtmpproto.c.
Referenced by append_flv_data(), and handle_metadata().
|
static |
Definition at line 2194 of file rtmpproto.c.
Referenced by get_packet(), and handle_notify().
|
static |
Definition at line 2227 of file rtmpproto.c.
Referenced by get_packet().
|
static |
Parse received packet and possibly perform some action depending on the packet contents.
Definition at line 2290 of file rtmpproto.c.
Referenced by get_packet(), and rtmp_write().
|
static |
Definition at line 2335 of file rtmpproto.c.
Referenced by get_packet().
|
static |
Interact with the server by receiving and sending RTMP packets until there is some significant data (media data or expected status notification).
s | reading context |
for_header | non-zero value tells function to work until it gets notification from the server that playing has been started, otherwise function will work until some media data is received (or an error happens) |
Definition at line 2396 of file rtmpproto.c.
Referenced by ff_audio_rechunk_interleave(), rtmp_open(), and rtmp_read().
|
static |
Definition at line 2479 of file rtmpproto.c.
Referenced by rtmp_open().
|
static |
Insert a fake onMetadata packet into the FLV stream to notify the FLV demuxer about the duration of the stream.
This should only be done if there was no real onMetadata packet sent by the server at the start of the stream and if we were able to retrieve a valid duration via a getStreamLength call.
Definition at line 2515 of file rtmpproto.c.
Referenced by rtmp_open().
|
static |
Open RTMP connection and verify that the stream can be played.
URL syntax: rtmp://server[:port][/app][/playpath] where 'app' is first one or two directories in the path (e.g. /ondemand/, /flash/live/, etc.) and 'playpath' is a file name (the rest of the path, may be prefixed with "mp4:")
Definition at line 2578 of file rtmpproto.c.
|
static |
Definition at line 2875 of file rtmpproto.c.
|
static |
Definition at line 2902 of file rtmpproto.c.
|
static |
Definition at line 2922 of file rtmpproto.c.
|
static |
Definition at line 2936 of file rtmpproto.c.
|
static |
Client key used for digest signing.
Definition at line 137 of file rtmpproto.c.
Referenced by rtmp_handshake(), and rtmp_handshake_imprint_with_digest().
|
static |
Key used for RTMP server digest signing.
Definition at line 148 of file rtmpproto.c.
Referenced by rtmp_handshake(), and rtmp_validate_digest().
|
static |
Definition at line 3081 of file rtmpproto.c.