7#include <packager/media/formats/mp4/mp4_muxer.h>
17#include <absl/log/check.h>
18#include <absl/log/log.h>
19#include <absl/strings/escaping.h>
20#include <absl/strings/string_view.h>
22#include <packager/macros/logging.h>
23#include <packager/macros/status.h>
24#include <packager/media/base/audio_stream_info.h>
25#include <packager/media/base/encryption_config.h>
26#include <packager/media/base/fourccs.h>
27#include <packager/media/base/media_handler.h>
28#include <packager/media/base/media_sample.h>
29#include <packager/media/base/muxer.h>
30#include <packager/media/base/range.h>
31#include <packager/media/base/stream_info.h>
32#include <packager/media/base/text_stream_info.h>
33#include <packager/media/base/video_stream_info.h>
34#include <packager/media/codecs/es_descriptor.h>
35#include <packager/media/event/muxer_listener.h>
36#include <packager/media/formats/mp4/box_definitions.h>
37#include <packager/media/formats/mp4/low_latency_segment_segmenter.h>
38#include <packager/media/formats/mp4/multi_segment_segmenter.h>
39#include <packager/media/formats/mp4/single_segment_segmenter.h>
40#include <packager/media/formats/ttml/ttml_generator.h>
41#include <packager/status.h>
51void SetStartAndEndFromOffsetAndSize(
size_t offset,
size_t size, Range* range) {
53 range->start =
static_cast<uint32_t
>(offset);
55 range->end = range->start +
static_cast<uint32_t
>(size) - 1;
58FourCC CodecToFourCC(Codec codec, H26xStreamFormat h26x_stream_format) {
63 return h26x_stream_format ==
64 H26xStreamFormat::kNalUnitStreamWithParameterSetNalus
68 return h26x_stream_format ==
69 H26xStreamFormat::kNalUnitStreamWithParameterSetNalus
72 case kCodecH265DolbyVision:
73 return h26x_stream_format ==
74 H26xStreamFormat::kNalUnitStreamWithParameterSetNalus
119void GenerateSinf(FourCC old_type,
120 const EncryptionConfig& encryption_config,
121 ProtectionSchemeInfo* sinf) {
122 sinf->format.format = old_type;
124 DCHECK_NE(encryption_config.protection_scheme, FOURCC_NULL);
125 sinf->type.type = encryption_config.protection_scheme;
128 const int kCencSchemeVersion = 0x00010000;
129 sinf->type.version = kCencSchemeVersion;
131 auto& track_encryption = sinf->info.track_encryption;
132 track_encryption.default_is_protected = 1;
134 track_encryption.default_crypt_byte_block =
135 encryption_config.crypt_byte_block;
136 track_encryption.default_skip_byte_block = encryption_config.skip_byte_block;
137 switch (encryption_config.protection_scheme) {
140 DCHECK_EQ(track_encryption.default_crypt_byte_block, 0u);
141 DCHECK_EQ(track_encryption.default_skip_byte_block, 0u);
144 track_encryption.version = 0;
151 track_encryption.version = 1;
154 NOTIMPLEMENTED() <<
"Unexpected protection scheme "
155 << encryption_config.protection_scheme;
158 track_encryption.default_per_sample_iv_size =
159 encryption_config.per_sample_iv_size;
160 track_encryption.default_constant_iv = encryption_config.constant_iv;
161 track_encryption.default_kid = encryption_config.key_id;
166int16_t GetRollDistance(uint64_t seek_preroll_ns, uint32_t sampling_frequency) {
167 const double kNanosecondsPerSecond = 1000000000;
168 const double preroll_in_samples =
169 seek_preroll_ns / kNanosecondsPerSecond * sampling_frequency;
171 return -
static_cast<int16_t
>(preroll_in_samples + 0.5);
177MP4Muxer::~MP4Muxer() {}
179Status MP4Muxer::InitializeMuxer() {
181 to_be_initialized_ =
true;
185Status MP4Muxer::Finalize() {
190 DCHECK(to_be_initialized_);
192 <<
"' which does not contain any sample.";
196 Status segmenter_finalized = segmenter_->Finalize();
198 if (!segmenter_finalized.ok())
199 return segmenter_finalized;
201 FireOnMediaEndEvent();
206Status MP4Muxer::AddMediaSample(
size_t stream_id,
const MediaSample& sample) {
207 if (to_be_initialized_) {
208 RETURN_IF_ERROR(UpdateEditListOffsetFromSample(sample));
209 RETURN_IF_ERROR(DelayInitializeMuxer());
210 to_be_initialized_ =
false;
213 return segmenter_->AddSample(stream_id, sample);
216Status MP4Muxer::FinalizeSegment(
size_t stream_id,
217 const SegmentInfo& segment_info) {
219 VLOG(3) <<
"Finalizing " << (segment_info.is_subsegment ?
"sub" :
"")
220 <<
"segment " << segment_info.start_timestamp <<
" duration "
221 << segment_info.duration <<
" segment number "
222 << segment_info.segment_number;
223 return segmenter_->FinalizeSegment(stream_id, segment_info);
226Status MP4Muxer::DelayInitializeMuxer() {
227 DCHECK(!streams().empty());
229 std::unique_ptr<FileType> ftyp(
new FileType);
230 std::unique_ptr<Movie> moov(
new Movie);
232 ftyp->major_brand = FOURCC_mp41;
233 ftyp->compatible_brands.push_back(FOURCC_iso8);
234 ftyp->compatible_brands.push_back(FOURCC_isom);
235 ftyp->compatible_brands.push_back(FOURCC_mp41);
236 ftyp->compatible_brands.push_back(FOURCC_dash);
238 if (streams().size() == 1) {
239 FourCC codec_fourcc = FOURCC_NULL;
240 if (streams()[0]->stream_type() == kStreamVideo) {
242 CodecToFourCC(streams()[0]->codec(),
243 static_cast<const VideoStreamInfo*
>(streams()[0].get())
244 ->h26x_stream_format());
245 if (codec_fourcc != FOURCC_NULL)
246 ftyp->compatible_brands.push_back(codec_fourcc);
249 std::string codec_string =
250 static_cast<const VideoStreamInfo*
>(streams()[0].get())
252 std::string supplemental_codec_string =
253 static_cast<const VideoStreamInfo*
>(streams()[0].get())
254 ->supplemental_codec();
255 if (codec_string.find(
"dvh") != std::string::npos ||
256 supplemental_codec_string.find(
"dvh") != std::string::npos ||
257 codec_string.find(
"dav1") != std::string::npos ||
258 supplemental_codec_string.find(
"dav1") != std::string::npos)
259 ftyp->compatible_brands.push_back(FOURCC_dby1);
261 static_cast<const VideoStreamInfo*
>(streams()[0].get())
262 ->compatible_brand();
263 if (extra_brand != FOURCC_NULL)
264 ftyp->compatible_brands.push_back(extra_brand);
270 if (codec_fourcc != FOURCC_avc3 && codec_fourcc != FOURCC_hev1)
271 ftyp->compatible_brands.push_back(FOURCC_cmfc);
273 if (streams()[0]->stream_type() == kStreamAudio) {
275 CodecToFourCC(streams()[0]->codec(), H26xStreamFormat::kUnSpecified);
276 if (codec_fourcc == FOURCC_iamf)
277 ftyp->compatible_brands.push_back(FOURCC_iamf);
281 moov->header.creation_time = IsoTimeNow();
282 moov->header.modification_time = IsoTimeNow();
283 moov->header.next_track_id =
static_cast<uint32_t
>(streams().size()) + 1;
285 moov->tracks.resize(streams().size());
286 moov->extends.tracks.resize(streams().size());
289 for (uint32_t i = 0; i < streams().size(); ++i) {
290 const StreamInfo* stream = streams()[i].get();
291 Track& trak = moov->tracks[i];
292 trak.header.track_id = i + 1;
294 TrackExtends& trex = moov->extends.tracks[i];
295 trex.track_id = trak.header.track_id;
296 trex.default_sample_description_index = 1;
298 bool generate_trak_result =
false;
299 switch (stream->stream_type()) {
301 generate_trak_result = GenerateVideoTrak(
302 static_cast<const VideoStreamInfo*
>(stream), &trak);
305 generate_trak_result = GenerateAudioTrak(
306 static_cast<const AudioStreamInfo*
>(stream), &trak);
309 generate_trak_result =
310 GenerateTextTrak(
static_cast<const TextStreamInfo*
>(stream), &trak);
313 NOTIMPLEMENTED() <<
"Not implemented for stream type: "
314 << stream->stream_type();
316 if (!generate_trak_result)
317 return Status(error::MUXER_FAILURE,
"Failed to generate trak.");
321 if (edit_list_offset_.value() > 0) {
323 entry.media_time = edit_list_offset_.value();
324 entry.media_rate_integer = 1;
325 trak.edit.list.edits.push_back(entry);
328 if (stream->is_encrypted() && options().mp4_params.include_pssh_in_stream) {
330 if (stream->encryption_config().protection_scheme !=
331 kAes128ProtectionScheme) {
333 const auto& key_system_info =
334 stream->encryption_config().key_system_info;
335 for (
const ProtectionSystemSpecificInfo& system : key_system_info) {
336 if (system.psshs.empty())
338 ProtectionSystemSpecificHeader pssh;
339 pssh.raw_box = system.psshs;
340 moov->pssh.push_back(pssh);
346 if (options().segment_template.empty()) {
347 segmenter_.reset(
new SingleSegmentSegmenter(options(), std::move(ftyp),
349 }
else if (options().mp4_params.low_latency_dash_mode) {
350 segmenter_.reset(
new LowLatencySegmentSegmenter(options(), std::move(ftyp),
354 new MultiSegmentSegmenter(options(), std::move(ftyp), std::move(moov)));
357 const Status segmenter_initialized =
358 segmenter_->Initialize(streams(), muxer_listener(), progress_listener());
359 if (!segmenter_initialized.ok())
360 return segmenter_initialized;
364 for (
const auto& stream : streams()) {
365 if (stream->is_encrypted() &&
366 stream->encryption_config().protection_scheme ==
367 kAes128ProtectionScheme) {
368 segmenter_->SetAes128EncryptionConfig(stream->encryption_config());
373 FireOnMediaStartEvent();
377Status MP4Muxer::UpdateEditListOffsetFromSample(
const MediaSample& sample) {
378 if (edit_list_offset_)
381 const int64_t pts = sample.pts();
382 const int64_t dts = sample.dts();
414 const int64_t pts_dts_offset = pts - dts;
415 if (pts_dts_offset > 0) {
417 LOG(ERROR) <<
"Negative presentation timestamp (" << pts
418 <<
") is not supported when there is an offset between "
419 "presentation timestamp and decoding timestamp ("
421 return Status(error::MUXER_FAILURE,
422 "Unsupported negative pts when there is an offset between "
425 edit_list_offset_ = pts_dts_offset;
428 if (pts_dts_offset < 0) {
429 LOG(ERROR) <<
"presentation timestamp (" << pts
430 <<
") is not supposed to be greater than decoding timestamp ("
432 return Status(error::MUXER_FAILURE,
"Not expecting pts < dts.");
434 edit_list_offset_ = std::max(-sample.pts(),
static_cast<int64_t
>(0));
438void MP4Muxer::InitializeTrak(
const StreamInfo* info, Track* trak) {
439 int64_t now = IsoTimeNow();
440 trak->header.creation_time = now;
441 trak->header.modification_time = now;
442 trak->header.duration = 0;
443 trak->media.header.creation_time = now;
444 trak->media.header.modification_time = now;
445 trak->media.header.timescale = info->time_scale();
446 trak->media.header.duration = 0;
447 if (!info->language().empty()) {
449 std::string main_language = info->language();
450 size_t dash = main_language.find(
'-');
451 if (dash != std::string::npos) {
452 main_language.erase(dash);
456 if (main_language.size() != 3) {
457 LOG(WARNING) <<
"'" << main_language <<
"' is not a valid ISO-639-2 "
458 <<
"language code, ignoring.";
460 trak->media.header.language.code = main_language;
465bool MP4Muxer::GenerateVideoTrak(
const VideoStreamInfo* video_info,
467 InitializeTrak(video_info, trak);
471 uint32_t pixel_width = video_info->pixel_width();
472 uint32_t pixel_height = video_info->pixel_height();
473 if (pixel_width == 0 || pixel_height == 0) {
474 LOG(WARNING) <<
"pixel width/height are not set. Assuming 1:1.";
478 const double sample_aspect_ratio =
479 static_cast<double>(pixel_width) / pixel_height;
480 trak->header.width = video_info->width() * sample_aspect_ratio * 0x10000;
481 trak->header.height = video_info->height() * 0x10000;
483 VideoSampleEntry video;
485 CodecToFourCC(video_info->codec(), video_info->h26x_stream_format());
486 video.width = video_info->width();
487 video.height = video_info->height();
488 video.colr.raw_box = video_info->colr_data();
489 video.codec_configuration.data = video_info->codec_config();
490 if (!video.ParseExtraCodecConfigsVector(video_info->extra_config())) {
491 LOG(ERROR) <<
"Malformed extra codec configs: "
492 << absl::BytesToHexString(
493 absl::string_view(
reinterpret_cast<const char*
>(
494 video_info->extra_config().data()),
495 video_info->extra_config().size()));
498 if (pixel_width != 1 || pixel_height != 1) {
499 video.pixel_aspect.h_spacing = pixel_width;
500 video.pixel_aspect.v_spacing = pixel_height;
503 SampleDescription& sample_description =
504 trak->media.information.sample_table.description;
505 sample_description.type = kVideo;
506 sample_description.video_entries.push_back(video);
508 if (video_info->is_encrypted()) {
510 if (video_info->encryption_config().protection_scheme !=
511 kAes128ProtectionScheme) {
512 if (video_info->has_clear_lead()) {
514 sample_description.video_entries.push_back(video);
517 VideoSampleEntry& entry = sample_description.video_entries[0];
518 GenerateSinf(entry.format, video_info->encryption_config(), &entry.sinf);
519 entry.format = FOURCC_encv;
525bool MP4Muxer::GenerateAudioTrak(
const AudioStreamInfo* audio_info,
527 InitializeTrak(audio_info, trak);
529 trak->header.volume = 0x100;
531 AudioSampleEntry audio;
533 CodecToFourCC(audio_info->codec(), H26xStreamFormat::kUnSpecified);
534 switch (audio_info->codec()) {
536 DecoderConfigDescriptor* decoder_config =
537 audio.esds.es_descriptor.mutable_decoder_config_descriptor();
538 decoder_config->set_object_type(ObjectType::kISO_14496_3);
539 decoder_config->set_max_bitrate(audio_info->max_bitrate());
540 decoder_config->set_avg_bitrate(audio_info->avg_bitrate());
541 decoder_config->mutable_decoder_specific_info_descriptor()->set_data(
542 audio_info->codec_config());
550 audio.ddts.extra_data = audio_info->codec_config();
551 audio.ddts.max_bitrate = audio_info->max_bitrate();
552 audio.ddts.avg_bitrate = audio_info->avg_bitrate();
553 audio.ddts.sampling_frequency = audio_info->sampling_frequency();
554 audio.ddts.pcm_sample_depth = audio_info->sample_bits();
557 audio.udts.data = audio_info->codec_config();
560 audio.dac3.data = audio_info->codec_config();
563 audio.dec3.data = audio_info->codec_config();
566 audio.dac4.data = audio_info->codec_config();
569 audio.alac.data = audio_info->codec_config();
572 audio.dfla.data = audio_info->codec_config();
575 DecoderConfigDescriptor* decoder_config =
576 audio.esds.es_descriptor.mutable_decoder_config_descriptor();
577 uint32_t samplerate = audio_info->sampling_frequency();
578 if (samplerate < 32000)
579 decoder_config->set_object_type(ObjectType::kISO_13818_3_MPEG1);
581 decoder_config->set_object_type(ObjectType::kISO_11172_3_MPEG1);
582 decoder_config->set_max_bitrate(audio_info->max_bitrate());
583 decoder_config->set_avg_bitrate(audio_info->avg_bitrate());
593 audio.dops.opus_identification_header = audio_info->codec_config();
596 audio.iacb.data = audio_info->codec_config();
600 audio.mhac.data = audio_info->codec_config();
603 NOTIMPLEMENTED() <<
" Unsupported audio codec " << audio_info->codec();
607 if (audio_info->codec() == kCodecAC3 || audio_info->codec() == kCodecEAC3) {
610 audio.channelcount = 2;
611 audio.samplesize = 16;
612 }
else if (audio_info->codec() == kCodecAC4) {
615 audio.channelcount = audio_info->num_channels();
617 audio.samplesize = 16;
618 }
else if (audio_info->codec() == kCodecIAMF) {
621 audio.channelcount = 0;
623 audio.channelcount = audio_info->num_channels();
624 audio.samplesize = audio_info->sample_bits();
630 audio_info->codec() == kCodecIAMF ? 0 : audio_info->sampling_frequency();
632 SampleTable& sample_table = trak->media.information.sample_table;
633 SampleDescription& sample_description = sample_table.description;
634 sample_description.type = kAudio;
635 sample_description.audio_entries.push_back(audio);
637 if (audio_info->is_encrypted()) {
639 if (audio_info->encryption_config().protection_scheme !=
640 kAes128ProtectionScheme) {
641 if (audio_info->has_clear_lead()) {
643 sample_description.audio_entries.push_back(audio);
646 AudioSampleEntry& entry = sample_description.audio_entries[0];
647 GenerateSinf(entry.format, audio_info->encryption_config(), &entry.sinf);
648 entry.format = FOURCC_enca;
652 if (audio_info->seek_preroll_ns() > 0) {
653 sample_table.sample_group_descriptions.resize(1);
654 SampleGroupDescription& sample_group_description =
655 sample_table.sample_group_descriptions.back();
656 sample_group_description.grouping_type = FOURCC_roll;
657 sample_group_description.audio_roll_recovery_entries.resize(1);
658 sample_group_description.audio_roll_recovery_entries[0].roll_distance =
659 GetRollDistance(audio_info->seek_preroll_ns(), audio.samplerate);
666bool MP4Muxer::GenerateTextTrak(
const TextStreamInfo* text_info, Track* trak) {
667 InitializeTrak(text_info, trak);
669 if (text_info->codec_string() ==
"wvtt") {
671 TextSampleEntry webvtt;
672 webvtt.format = FOURCC_wvtt;
678 webvtt.config.config =
"WEBVTT";
681 if (!text_info->regions().empty() || !text_info->css_styles().empty()) {
682 LOG(INFO) <<
"Skipping possible style / region configuration as the spec "
683 "does not define a way to carry them inside ISO-BMFF files.";
689 webvtt.label.source_label =
"source_label";
690 SampleDescription& sample_description =
691 trak->media.information.sample_table.description;
692 sample_description.type = kText;
693 sample_description.text_entries.push_back(webvtt);
695 }
else if (text_info->codec_string() ==
"ttml") {
697 TextSampleEntry ttml;
698 ttml.format = FOURCC_stpp;
699 ttml.namespace_ = ttml::TtmlGenerator::kTtNamespace;
701 SampleDescription& sample_description =
702 trak->media.information.sample_table.description;
703 sample_description.type = kSubtitle;
704 sample_description.text_entries.push_back(ttml);
707 NOTIMPLEMENTED() << text_info->codec_string()
708 <<
" handling not implemented yet.";
712std::optional<Range> MP4Muxer::GetInitRangeStartAndEnd() {
713 size_t range_offset = 0;
714 size_t range_size = 0;
715 const bool has_range = segmenter_->GetInitRange(&range_offset, &range_size);
721 SetStartAndEndFromOffsetAndSize(range_offset, range_size, &range);
725std::optional<Range> MP4Muxer::GetIndexRangeStartAndEnd() {
726 size_t range_offset = 0;
727 size_t range_size = 0;
728 const bool has_range = segmenter_->GetIndexRange(&range_offset, &range_size);
734 SetStartAndEndFromOffsetAndSize(range_offset, range_size, &range);
738void MP4Muxer::FireOnMediaStartEvent() {
739 if (!muxer_listener())
742 if (streams().size() > 1) {
743 LOG(ERROR) <<
"MuxerListener cannot take more than 1 stream.";
746 DCHECK(!streams().empty()) <<
"Media started without a stream.";
748 const int32_t timescale = segmenter_->GetReferenceTimeScale();
749 muxer_listener()->
OnMediaStart(options(), *streams().front(), timescale,
750 MuxerListener::kContainerMp4);
753void MP4Muxer::FireOnMediaEndEvent() {
754 if (!muxer_listener())
757 MuxerListener::MediaRanges media_range;
758 media_range.init_range = GetInitRangeStartAndEnd();
759 media_range.index_range = GetIndexRangeStartAndEnd();
760 media_range.subsegment_ranges = segmenter_->GetSegmentRanges();
762 const float duration_seconds =
static_cast<float>(segmenter_->GetDuration());
763 muxer_listener()->
OnMediaEnd(media_range, duration_seconds);
766uint64_t MP4Muxer::IsoTimeNow() {
768 const uint64_t kIsomTimeOffset = 2082844800l;
771 std::int64_t secondsSince1970 = Now();
774 return secondsSince1970 + kIsomTimeOffset;
All the methods that are virtual are virtual for mocking.