3 * Copyright (c) 2003 The FFmpeg Project
5 * This file is part of FFmpeg.
7 * FFmpeg is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
12 * FFmpeg is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with FFmpeg; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
22 #include "libavutil/intreadwrite.h"
23 #include "libavutil/dict.h"
24 #include "libavutil/intfloat.h"
25 #include "libavutil/avassert.h"
33 static const AVCodecTag flv_video_codec_ids[] = {
34 { AV_CODEC_ID_FLV1, FLV_CODECID_H263 },
35 { AV_CODEC_ID_H263, FLV_CODECID_REALH263 },
36 { AV_CODEC_ID_MPEG4, FLV_CODECID_MPEG4 },
37 { AV_CODEC_ID_FLASHSV, FLV_CODECID_SCREEN },
38 { AV_CODEC_ID_FLASHSV2, FLV_CODECID_SCREEN2 },
39 { AV_CODEC_ID_VP6F, FLV_CODECID_VP6 },
40 { AV_CODEC_ID_VP6, FLV_CODECID_VP6 },
41 { AV_CODEC_ID_VP6A, FLV_CODECID_VP6A },
42 { AV_CODEC_ID_H264, FLV_CODECID_H264 },
43 { AV_CODEC_ID_NONE, 0 }
46 static const AVCodecTag flv_audio_codec_ids[] = {
47 { AV_CODEC_ID_MP3, FLV_CODECID_MP3 >> FLV_AUDIO_CODECID_OFFSET },
48 { AV_CODEC_ID_PCM_U8, FLV_CODECID_PCM >> FLV_AUDIO_CODECID_OFFSET },
49 { AV_CODEC_ID_PCM_S16BE, FLV_CODECID_PCM >> FLV_AUDIO_CODECID_OFFSET },
50 { AV_CODEC_ID_PCM_S16LE, FLV_CODECID_PCM_LE >> FLV_AUDIO_CODECID_OFFSET },
51 { AV_CODEC_ID_ADPCM_SWF, FLV_CODECID_ADPCM >> FLV_AUDIO_CODECID_OFFSET },
52 { AV_CODEC_ID_AAC, FLV_CODECID_AAC >> FLV_AUDIO_CODECID_OFFSET },
53 { AV_CODEC_ID_NELLYMOSER, FLV_CODECID_NELLYMOSER >> FLV_AUDIO_CODECID_OFFSET },
54 { AV_CODEC_ID_PCM_MULAW, FLV_CODECID_PCM_MULAW >> FLV_AUDIO_CODECID_OFFSET },
55 { AV_CODEC_ID_PCM_ALAW, FLV_CODECID_PCM_ALAW >> FLV_AUDIO_CODECID_OFFSET },
56 { AV_CODEC_ID_SPEEX, FLV_CODECID_SPEEX >> FLV_AUDIO_CODECID_OFFSET },
57 { AV_CODEC_ID_NONE, 0 }
60 typedef struct FLVContext {
62 int64_t duration_offset;
63 int64_t filesize_offset;
65 int64_t delay; ///< first dts delay (needed for AVC & Speex)
68 typedef struct FLVStreamContext {
69 int64_t last_ts; ///< last timestamp for each stream
72 static int get_audio_flags(AVFormatContext *s, AVCodecContext *enc)
74 int flags = (enc->bits_per_coded_sample == 16) ? FLV_SAMPLESSIZE_16BIT
75 : FLV_SAMPLESSIZE_8BIT;
77 if (enc->codec_id == AV_CODEC_ID_AAC) // specs force these parameters
78 return FLV_CODECID_AAC | FLV_SAMPLERATE_44100HZ |
79 FLV_SAMPLESSIZE_16BIT | FLV_STEREO;
80 else if (enc->codec_id == AV_CODEC_ID_SPEEX) {
81 if (enc->sample_rate != 16000) {
82 av_log(s, AV_LOG_ERROR,
83 "FLV only supports wideband (16kHz) Speex audio\n");
84 return AVERROR(EINVAL);
86 if (enc->channels != 1) {
87 av_log(s, AV_LOG_ERROR, "FLV only supports mono Speex audio\n");
88 return AVERROR(EINVAL);
90 return FLV_CODECID_SPEEX | FLV_SAMPLERATE_11025HZ | FLV_SAMPLESSIZE_16BIT;
92 switch (enc->sample_rate) {
94 flags |= FLV_SAMPLERATE_44100HZ;
97 flags |= FLV_SAMPLERATE_22050HZ;
100 flags |= FLV_SAMPLERATE_11025HZ;
102 case 16000: // nellymoser only
103 case 8000: // nellymoser only
104 case 5512: // not MP3
105 if (enc->codec_id != AV_CODEC_ID_MP3) {
106 flags |= FLV_SAMPLERATE_SPECIAL;
110 av_log(s, AV_LOG_ERROR,
111 "FLV does not support sample rate %d, "
112 "choose from (44100, 22050, 11025)\n", enc->sample_rate);
113 return AVERROR(EINVAL);
117 if (enc->channels > 1)
120 switch (enc->codec_id) {
121 case AV_CODEC_ID_MP3:
122 flags |= FLV_CODECID_MP3 | FLV_SAMPLESSIZE_16BIT;
124 case AV_CODEC_ID_PCM_U8:
125 flags |= FLV_CODECID_PCM | FLV_SAMPLESSIZE_8BIT;
127 case AV_CODEC_ID_PCM_S16BE:
128 flags |= FLV_CODECID_PCM | FLV_SAMPLESSIZE_16BIT;
130 case AV_CODEC_ID_PCM_S16LE:
131 flags |= FLV_CODECID_PCM_LE | FLV_SAMPLESSIZE_16BIT;
133 case AV_CODEC_ID_ADPCM_SWF:
134 flags |= FLV_CODECID_ADPCM | FLV_SAMPLESSIZE_16BIT;
136 case AV_CODEC_ID_NELLYMOSER:
137 if (enc->sample_rate == 8000)
138 flags |= FLV_CODECID_NELLYMOSER_8KHZ_MONO | FLV_SAMPLESSIZE_16BIT;
139 else if (enc->sample_rate == 16000)
140 flags |= FLV_CODECID_NELLYMOSER_16KHZ_MONO | FLV_SAMPLESSIZE_16BIT;
142 flags |= FLV_CODECID_NELLYMOSER | FLV_SAMPLESSIZE_16BIT;
144 case AV_CODEC_ID_PCM_MULAW:
145 flags = FLV_CODECID_PCM_MULAW | FLV_SAMPLERATE_SPECIAL | FLV_SAMPLESSIZE_16BIT;
147 case AV_CODEC_ID_PCM_ALAW:
148 flags = FLV_CODECID_PCM_ALAW | FLV_SAMPLERATE_SPECIAL | FLV_SAMPLESSIZE_16BIT;
151 flags |= enc->codec_tag << 4;
154 av_log(s, AV_LOG_ERROR, "Audio codec '%s' not compatible with FLV\n",
155 avcodec_get_name(enc->codec_id));
156 return AVERROR(EINVAL);
162 static void put_amf_string(AVIOContext *pb, const char *str)
164 size_t len = strlen(str);
166 avio_write(pb, str, len);
169 static void put_avc_eos_tag(AVIOContext *pb, unsigned ts)
171 avio_w8(pb, FLV_TAG_TYPE_VIDEO);
172 avio_wb24(pb, 5); /* Tag Data Size */
173 avio_wb24(pb, ts); /* lower 24 bits of timestamp in ms */
174 avio_w8(pb, (ts >> 24) & 0x7F); /* MSB of ts in ms */
175 avio_wb24(pb, 0); /* StreamId = 0 */
176 avio_w8(pb, 23); /* ub[4] FrameType = 1, ub[4] CodecId = 7 */
177 avio_w8(pb, 2); /* AVC end of sequence */
178 avio_wb24(pb, 0); /* Always 0 for AVC EOS. */
179 avio_wb32(pb, 16); /* Size of FLV tag */
182 static void put_amf_double(AVIOContext *pb, double d)
184 avio_w8(pb, AMF_DATA_TYPE_NUMBER);
185 avio_wb64(pb, av_double2int(d));
188 static void put_amf_bool(AVIOContext *pb, int b)
190 avio_w8(pb, AMF_DATA_TYPE_BOOL);
194 static int flv_write_header(AVFormatContext *s)
196 AVIOContext *pb = s->pb;
197 FLVContext *flv = s->priv_data;
198 AVCodecContext *audio_enc = NULL, *video_enc = NULL, *data_enc = NULL;
199 int i, metadata_count = 0;
200 double framerate = 0.0;
201 int64_t metadata_size_pos, data_size, metadata_count_pos;
202 AVDictionaryEntry *tag = NULL;
204 for (i = 0; i < s->nb_streams; i++) {
205 AVCodecContext *enc = s->streams[i]->codec;
206 FLVStreamContext *sc;
207 switch (enc->codec_type) {
208 case AVMEDIA_TYPE_VIDEO:
209 if (s->streams[i]->avg_frame_rate.den &&
210 s->streams[i]->avg_frame_rate.num) {
211 framerate = av_q2d(s->streams[i]->avg_frame_rate);
213 framerate = 1 / av_q2d(s->streams[i]->codec->time_base);
216 if (enc->codec_tag == 0) {
217 av_log(s, AV_LOG_ERROR, "Video codec '%s' for stream %d is not compatible with FLV\n",
218 avcodec_get_name(enc->codec_id), i);
219 return AVERROR(EINVAL);
222 case AVMEDIA_TYPE_AUDIO:
224 if (get_audio_flags(s, enc) < 0)
225 return AVERROR_INVALIDDATA;
227 case AVMEDIA_TYPE_DATA:
228 if (enc->codec_id != AV_CODEC_ID_TEXT) {
229 av_log(s, AV_LOG_ERROR, "Data codec '%s' for stream %d is not compatible with FLV\n",
230 avcodec_get_name(enc->codec_id), i);
231 return AVERROR_INVALIDDATA;
236 av_log(s, AV_LOG_ERROR, "Codec type '%s' for stream %d is not compatible with FLV\n",
237 av_get_media_type_string(enc->codec_type), i);
238 return AVERROR(EINVAL);
240 avpriv_set_pts_info(s->streams[i], 32, 1, 1000); /* 32 bit pts in ms */
242 sc = av_mallocz(sizeof(FLVStreamContext));
244 return AVERROR(ENOMEM);
245 s->streams[i]->priv_data = sc;
249 flv->delay = AV_NOPTS_VALUE;
251 avio_write(pb, "FLV", 3);
253 avio_w8(pb, FLV_HEADER_FLAG_HASAUDIO * !!audio_enc +
254 FLV_HEADER_FLAG_HASVIDEO * !!video_enc);
258 for (i = 0; i < s->nb_streams; i++)
259 if (s->streams[i]->codec->codec_tag == 5) {
260 avio_w8(pb, 8); // message type
261 avio_wb24(pb, 0); // include flags
262 avio_wb24(pb, 0); // time stamp
263 avio_wb32(pb, 0); // reserved
264 avio_wb32(pb, 11); // size
269 avio_w8(pb, 18); // tag type META
270 metadata_size_pos = avio_tell(pb);
271 avio_wb24(pb, 0); // size of data part (sum of all parts below)
272 avio_wb24(pb, 0); // timestamp
273 avio_wb32(pb, 0); // reserved
275 /* now data of data_size size */
277 /* first event name as a string */
278 avio_w8(pb, AMF_DATA_TYPE_STRING);
279 put_amf_string(pb, "onMetaData"); // 12 bytes
281 /* mixed array (hash) with size and string/type/data tuples */
282 avio_w8(pb, AMF_DATA_TYPE_MIXEDARRAY);
283 metadata_count_pos = avio_tell(pb);
284 metadata_count = 5 * !!video_enc +
287 2; // +2 for duration and file size
289 avio_wb32(pb, metadata_count);
291 put_amf_string(pb, "duration");
292 flv->duration_offset= avio_tell(pb);
294 // fill in the guessed duration, it'll be corrected later if incorrect
295 put_amf_double(pb, s->duration / AV_TIME_BASE);
298 put_amf_string(pb, "width");
299 put_amf_double(pb, video_enc->width);
301 put_amf_string(pb, "height");
302 put_amf_double(pb, video_enc->height);
304 put_amf_string(pb, "videodatarate");
305 put_amf_double(pb, video_enc->bit_rate / 1024.0);
307 put_amf_string(pb, "framerate");
308 put_amf_double(pb, framerate);
310 put_amf_string(pb, "videocodecid");
311 put_amf_double(pb, video_enc->codec_tag);
315 put_amf_string(pb, "audiodatarate");
316 put_amf_double(pb, audio_enc->bit_rate / 1024.0);
318 put_amf_string(pb, "audiosamplerate");
319 put_amf_double(pb, audio_enc->sample_rate);
321 put_amf_string(pb, "audiosamplesize");
322 put_amf_double(pb, audio_enc->codec_id == AV_CODEC_ID_PCM_U8 ? 8 : 16);
324 put_amf_string(pb, "stereo");
325 put_amf_bool(pb, audio_enc->channels == 2);
327 put_amf_string(pb, "audiocodecid");
328 put_amf_double(pb, audio_enc->codec_tag);
332 put_amf_string(pb, "datastream");
333 put_amf_double(pb, 0.0);
336 while ((tag = av_dict_get(s->metadata, "", tag, AV_DICT_IGNORE_SUFFIX))) {
337 if( !strcmp(tag->key, "width")
338 ||!strcmp(tag->key, "height")
339 ||!strcmp(tag->key, "videodatarate")
340 ||!strcmp(tag->key, "framerate")
341 ||!strcmp(tag->key, "videocodecid")
342 ||!strcmp(tag->key, "audiodatarate")
343 ||!strcmp(tag->key, "audiosamplerate")
344 ||!strcmp(tag->key, "audiosamplesize")
345 ||!strcmp(tag->key, "stereo")
346 ||!strcmp(tag->key, "audiocodecid")
347 ||!strcmp(tag->key, "duration")
348 ||!strcmp(tag->key, "onMetaData")
350 av_log(s, AV_LOG_DEBUG, "Ignoring metadata for %s\n", tag->key);
353 put_amf_string(pb, tag->key);
354 avio_w8(pb, AMF_DATA_TYPE_STRING);
355 put_amf_string(pb, tag->value);
359 put_amf_string(pb, "filesize");
360 flv->filesize_offset = avio_tell(pb);
361 put_amf_double(pb, 0); // delayed write
363 put_amf_string(pb, "");
364 avio_w8(pb, AMF_END_OF_OBJECT);
366 /* write total size of tag */
367 data_size = avio_tell(pb) - metadata_size_pos - 10;
369 avio_seek(pb, metadata_count_pos, SEEK_SET);
370 avio_wb32(pb, metadata_count);
372 avio_seek(pb, metadata_size_pos, SEEK_SET);
373 avio_wb24(pb, data_size);
374 avio_skip(pb, data_size + 10 - 3);
375 avio_wb32(pb, data_size + 11);
377 for (i = 0; i < s->nb_streams; i++) {
378 AVCodecContext *enc = s->streams[i]->codec;
379 if (enc->codec_id == AV_CODEC_ID_AAC || enc->codec_id == AV_CODEC_ID_H264 || enc->codec_id == AV_CODEC_ID_MPEG4) {
381 avio_w8(pb, enc->codec_type == AVMEDIA_TYPE_VIDEO ?
382 FLV_TAG_TYPE_VIDEO : FLV_TAG_TYPE_AUDIO);
383 avio_wb24(pb, 0); // size patched later
384 avio_wb24(pb, 0); // ts
385 avio_w8(pb, 0); // ts ext
386 avio_wb24(pb, 0); // streamid
388 if (enc->codec_id == AV_CODEC_ID_AAC) {
389 avio_w8(pb, get_audio_flags(s, enc));
390 avio_w8(pb, 0); // AAC sequence header
391 avio_write(pb, enc->extradata, enc->extradata_size);
393 avio_w8(pb, enc->codec_tag | FLV_FRAME_KEY); // flags
394 avio_w8(pb, 0); // AVC sequence header
395 avio_wb24(pb, 0); // composition time
396 ff_isom_write_avcc(pb, enc->extradata, enc->extradata_size);
398 data_size = avio_tell(pb) - pos;
399 avio_seek(pb, -data_size - 10, SEEK_CUR);
400 avio_wb24(pb, data_size);
401 avio_skip(pb, data_size + 10 - 3);
402 avio_wb32(pb, data_size + 11); // previous tag size
409 static int flv_write_trailer(AVFormatContext *s)
413 AVIOContext *pb = s->pb;
414 FLVContext *flv = s->priv_data;
418 for (i = 0; i < s->nb_streams; i++) {
419 AVCodecContext *enc = s->streams[i]->codec;
420 FLVStreamContext *sc = s->streams[i]->priv_data;
421 if (enc->codec_type == AVMEDIA_TYPE_VIDEO &&
422 (enc->codec_id == AV_CODEC_ID_H264 || enc->codec_id == AV_CODEC_ID_MPEG4))
423 put_avc_eos_tag(pb, sc->last_ts);
426 file_size = avio_tell(pb);
428 /* update information */
429 if(avio_seek(pb, flv->duration_offset, SEEK_SET) < 0)
430 av_log(s, AV_LOG_WARNING, "Failed to update header with correct duration.\n");
432 put_amf_double(pb, flv->duration / (double)1000);
433 if(avio_seek(pb, flv->filesize_offset, SEEK_SET) < 0)
434 av_log(s, AV_LOG_WARNING, "Failed to update header with correct filesize.\n");
436 put_amf_double(pb, file_size);
438 avio_seek(pb, file_size, SEEK_SET);
442 static int flv_write_packet(AVFormatContext *s, AVPacket *pkt)
444 AVIOContext *pb = s->pb;
445 AVCodecContext *enc = s->streams[pkt->stream_index]->codec;
446 FLVContext *flv = s->priv_data;
447 FLVStreamContext *sc = s->streams[pkt->stream_index]->priv_data;
449 int size = pkt->size;
450 uint8_t *data = NULL;
451 int flags = -1, flags_size, ret;
453 if (enc->codec_id == AV_CODEC_ID_VP6 || enc->codec_id == AV_CODEC_ID_VP6F ||
454 enc->codec_id == AV_CODEC_ID_VP6A || enc->codec_id == AV_CODEC_ID_AAC)
456 else if (enc->codec_id == AV_CODEC_ID_H264 || enc->codec_id == AV_CODEC_ID_MPEG4)
461 switch (enc->codec_type) {
462 case AVMEDIA_TYPE_VIDEO:
463 avio_w8(pb, FLV_TAG_TYPE_VIDEO);
465 flags = enc->codec_tag;
467 av_log(s, AV_LOG_ERROR,
468 "Video codec '%s' is not compatible with FLV\n",
469 avcodec_get_name(enc->codec_id));
470 return AVERROR(EINVAL);
473 flags |= pkt->flags & AV_PKT_FLAG_KEY ? FLV_FRAME_KEY : FLV_FRAME_INTER;
475 case AVMEDIA_TYPE_AUDIO:
476 flags = get_audio_flags(s, enc);
480 avio_w8(pb, FLV_TAG_TYPE_AUDIO);
482 case AVMEDIA_TYPE_DATA:
483 avio_w8(pb, FLV_TAG_TYPE_META);
486 return AVERROR(EINVAL);
489 if (enc->codec_id == AV_CODEC_ID_H264 || enc->codec_id == AV_CODEC_ID_MPEG4) {
490 /* check if extradata looks like mp4 formated */
491 if (enc->extradata_size > 0 && *(uint8_t*)enc->extradata != 1)
492 if ((ret = ff_avc_parse_nal_units_buf(pkt->data, &data, &size)) < 0)
494 } else if (enc->codec_id == AV_CODEC_ID_AAC && pkt->size > 2 &&
495 (AV_RB16(pkt->data) & 0xfff0) == 0xfff0) {
496 av_log(s, AV_LOG_ERROR, "Malformed AAC bitstream detected: "
497 "use audio bitstream filter 'aac_adtstoasc' to fix it "
498 "('-bsf:a aac_adtstoasc' option with ffmpeg)\n");
499 return AVERROR_INVALIDDATA;
502 if (flv->delay == AV_NOPTS_VALUE)
503 flv->delay = -pkt->dts;
505 if (pkt->dts < -flv->delay) {
506 av_log(s, AV_LOG_WARNING,
507 "Packets are not in the proper order with respect to DTS\n");
508 return AVERROR(EINVAL);
511 ts = pkt->dts + flv->delay; // add delay to force positive dts
513 /* check Speex packet duration */
514 if (enc->codec_id == AV_CODEC_ID_SPEEX && ts - sc->last_ts > 160)
515 av_log(s, AV_LOG_WARNING, "Warning: Speex stream has more than "
516 "8 frames per packet. Adobe Flash "
517 "Player cannot handle this!\n");
519 if (sc->last_ts < ts)
522 avio_wb24(pb, size + flags_size);
524 avio_w8(pb, (ts >> 24) & 0x7F); // timestamps are 32 bits _signed_
525 avio_wb24(pb, flv->reserved);
527 if (enc->codec_type == AVMEDIA_TYPE_DATA) {
529 int metadata_size_pos = avio_tell(pb);
530 avio_w8(pb, AMF_DATA_TYPE_STRING);
531 put_amf_string(pb, "onTextData");
532 avio_w8(pb, AMF_DATA_TYPE_MIXEDARRAY);
534 put_amf_string(pb, "type");
535 avio_w8(pb, AMF_DATA_TYPE_STRING);
536 put_amf_string(pb, "Text");
537 put_amf_string(pb, "text");
538 avio_w8(pb, AMF_DATA_TYPE_STRING);
539 put_amf_string(pb, pkt->data);
540 put_amf_string(pb, "");
541 avio_w8(pb, AMF_END_OF_OBJECT);
542 /* write total size of tag */
543 data_size = avio_tell(pb) - metadata_size_pos;
544 avio_seek(pb, metadata_size_pos - 10, SEEK_SET);
545 avio_wb24(pb, data_size);
546 avio_seek(pb, data_size + 10 - 3, SEEK_CUR);
547 avio_wb32(pb, data_size + 11);
549 av_assert1(flags>=0);
551 if (enc->codec_id == AV_CODEC_ID_VP6)
553 if (enc->codec_id == AV_CODEC_ID_VP6F || enc->codec_id == AV_CODEC_ID_VP6A)
554 avio_w8(pb, enc->extradata_size ? enc->extradata[0] : 0);
555 else if (enc->codec_id == AV_CODEC_ID_AAC)
556 avio_w8(pb,1); // AAC raw
557 else if (enc->codec_id == AV_CODEC_ID_H264 || enc->codec_id == AV_CODEC_ID_MPEG4) {
558 avio_w8(pb,1); // AVC NALU
559 avio_wb24(pb,pkt->pts - pkt->dts);
562 avio_write(pb, data ? data : pkt->data, size);
564 avio_wb32(pb, size + flags_size + 11); // previous tag size
565 flv->duration = FFMAX(flv->duration,
566 pkt->pts + flv->delay + pkt->duration);
575 AVOutputFormat ff_flv_muxer = {
577 .long_name = NULL_IF_CONFIG_SMALL("FLV (Flash Video)"),
578 .mime_type = "video/x-flv",
580 .priv_data_size = sizeof(FLVContext),
581 .audio_codec = CONFIG_LIBMP3LAME ? AV_CODEC_ID_MP3 : AV_CODEC_ID_ADPCM_SWF,
582 .video_codec = AV_CODEC_ID_FLV1,
583 .write_header = flv_write_header,
584 .write_packet = flv_write_packet,
585 .write_trailer = flv_write_trailer,
586 .codec_tag = (const AVCodecTag* const []) {
587 flv_video_codec_ids, flv_audio_codec_ids, 0
589 .flags = AVFMT_GLOBALHEADER | AVFMT_VARIABLE_FPS |