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 | RTMP_CTRL_ABORT_MESSAGE (2) |
#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 | handle_server_bw (URLContext *s, RTMPPacket *pkt) |
static int | handle_client_bw (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 | 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 RTMP_CTRL_ABORT_MESSAGE (2) |
Definition at line 405 of file rtmpproto.c.
Referenced by read_connect().
#define OFFSET | ( | x | ) | offsetof(RTMPContext, x) |
Definition at line 3106 of file rtmpproto.c.
#define DEC AV_OPT_FLAG_DECODING_PARAM |
Definition at line 3107 of file rtmpproto.c.
#define ENC AV_OPT_FLAG_ENCODING_PARAM |
Definition at line 3108 of file rtmpproto.c.
#define RTMP_PROTOCOL | ( | flavor | ) |
Definition at line 3134 of file rtmpproto.c.
enum ClientState |
RTMP protocol handler state.
Definition at line 59 of file rtmpproto.c.
|
static |
Definition at line 1519 of file rtmpproto.c.
Referenced by read_connect(), and rtmp_parse_result().
|
static |
Definition at line 1603 of file rtmpproto.c.
Referenced by read_connect(), and rtmp_parse_result().
|
static |
Definition at line 1579 of file rtmpproto.c.
Referenced by read_connect(), and rtmp_parse_result().
|
static |
Definition at line 162 of file rtmpproto.c.
Referenced by rtmp_send_packet().
|
static |
Definition at line 185 of file rtmpproto.c.
Referenced by find_tracked_method().
|
static |
Definition at line 192 of file rtmpproto.c.
Referenced by handle_invoke_error(), and handle_invoke_result().
|
static |
Definition at line 217 of file rtmpproto.c.
Referenced by rtmp_close(), and rtmp_open().
|
static |
Definition at line 228 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 256 of file rtmpproto.c.
Referenced by gen_connect().
|
static |
Generate 'connect' call and send it to the server.
Definition at line 319 of file rtmpproto.c.
Referenced by rtmp_open().
|
static |
Definition at line 407 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 591 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 615 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 639 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 663 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 688 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 714 of file rtmpproto.c.
Referenced by handle_invoke_result().
|
static |
Generate client buffer time and send it to the server.
Definition at line 736 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 758 of file rtmpproto.c.
Referenced by handle_invoke_result().
|
static |
Definition at line 782 of file rtmpproto.c.
Referenced by rtmp_seek().
|
static |
Generate a pause packet that either pauses or unpauses the current stream.
Definition at line 808 of file rtmpproto.c.
Referenced by rtmp_pause().
|
static |
Generate 'publish' call and send it to the server.
Definition at line 835 of file rtmpproto.c.
Referenced by handle_invoke_result().
|
static |
Generate ping reply and send it to the server.
Definition at line 862 of file rtmpproto.c.
Referenced by handle_ping().
|
static |
Generate SWF verification message and send it to the server.
Definition at line 888 of file rtmpproto.c.
Referenced by handle_ping().
|
static |
Generate server bandwidth message and send it to the server.
Definition at line 909 of file rtmpproto.c.
Referenced by handle_invoke_result().
|
static |
Generate check bandwidth message and send it to the server.
Definition at line 928 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 949 of file rtmpproto.c.
Referenced by get_packet().
|
static |
Definition at line 965 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 985 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 1008 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 1028 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 1053 of file rtmpproto.c.
Referenced by rtmp_handshake().
|
static |
Definition at line 1071 of file rtmpproto.c.
Referenced by rtmp_handshake().
|
static |
Definition at line 1139 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 1225 of file rtmpproto.c.
Referenced by rtmp_open().
|
static |
Definition at line 1404 of file rtmpproto.c.
Referenced by rtmp_server_handshake().
|
static |
Definition at line 1425 of file rtmpproto.c.
Referenced by rtmp_server_handshake().
|
static |
|
static |
Definition at line 1552 of file rtmpproto.c.
Referenced by rtmp_parse_result().
|
static |
Definition at line 1625 of file rtmpproto.c.
Referenced by handle_connect_error().
|
static |
Definition at line 1664 of file rtmpproto.c.
Referenced by handle_connect_error().
|
static |
Definition at line 1723 of file rtmpproto.c.
Referenced by handle_invoke_error().
|
static |
Definition at line 1814 of file rtmpproto.c.
Referenced by handle_invoke().
|
static |
Definition at line 1853 of file rtmpproto.c.
Referenced by send_invoke_response().
|
static |
Definition at line 1879 of file rtmpproto.c.
Referenced by send_invoke_response().
|
static |
Definition at line 1925 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 2034 of file rtmpproto.c.
Referenced by handle_invoke_result().
|
static |
Definition at line 2064 of file rtmpproto.c.
Referenced by handle_invoke().
|
static |
Definition at line 2136 of file rtmpproto.c.
Referenced by handle_invoke().
|
static |
Definition at line 2173 of file rtmpproto.c.
Referenced by rtmp_parse_result().
|
static |
Definition at line 2204 of file rtmpproto.c.
Referenced by append_flv_data(), and handle_metadata().
|
static |
Definition at line 2223 of file rtmpproto.c.
Referenced by get_packet(), and handle_notify().
|
static |
Definition at line 2256 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 2319 of file rtmpproto.c.
Referenced by get_packet(), and rtmp_write().
|
static |
Definition at line 2364 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 2425 of file rtmpproto.c.
Referenced by ff_audio_rechunk_interleave(), rtmp_open(), and rtmp_read().
|
static |
Definition at line 2508 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 2544 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 2607 of file rtmpproto.c.
|
static |
Definition at line 2904 of file rtmpproto.c.
|
static |
Definition at line 2931 of file rtmpproto.c.
|
static |
Definition at line 2951 of file rtmpproto.c.
|
static |
Definition at line 2965 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 3110 of file rtmpproto.c.