01 April 2021

Disabled Non-S3 Sources for Ludicrous Mode Media

❗️
Note
Non-S3 source files not supported for Ludicrous Mode media.

Black Frame Padding

Added option to append black frames before and after output video. If closed captions or audio channels are present they will be padded accordingly.

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>AddMedia</action>
    <source>[SourceFile]</source> <!-- required-->
    <format> <!-- required -->
        <output>[output]</output> <!-- required -->
        <black_padding_start>[FramesPadding]</black_padding_start>
        <black_padding_end>[FramesPadding]</black_padding_end>
        <!-- format parameters -->
    </format>
</query>

{
    "query": {
        "userid": "<<id>>", // required
        "userkey": "<<key>>", // required
        "action": "addMedia", // required
        "source": "[SourceFile]", // required
        "format": {
            "output": "[output]", // required
            "black_padding_start": "[FramesPadding]",
            "black_padding_end": "[FramesPadding]"
            // format parameters
        }
    }
}

Parameter	Description	Allowed Values	Default Value
black_padding_start	Prepends a specified number of black frames before video	Positive integer number	0
black_padding_end	Appends a specified number of black frames after video	Positive integer number	0

Trim only black frames from video's start and end

Added new cut_black parameter that trims black frames (if detected) only from the start and end of the video. If closed captions or audio channels are present they will be trimmed accordingly.

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
    <source>[SourceFile]</source> <!-- required-->
    <format>
        <output>[output]</output> <!-- required -->
        <cut_black>
            <enable>yes</enable>
            <trim>[yes|no]</trim>
        </cut_black>
        <!-- format parameters -->
    </format>
</query>

{
    "query": {
        "userid": "<<id>>", // required
        "userkey": "<<key>>", // required
        "action": "[Action]", // required
        "source": "[SourceFile]", // required
        "format": {
            "output": "[output]", // required
            "cut_black": {
                "enable": "yes",
                "trim": "[yes|no]"
            }
            // format parameters
        }
    }
}

Parameter	Description	Allowed Values	Default Value
trim	Trim black frames only from start and end of the video	yes, no	no

Align Audio Only Stream to Framerate

Added option to align audio-only stream of the Advanced Multi-Bitrate format to specified framrate.

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required -->
    <userkey><<key>></userkey> <!-- required -->
    <action>[Action]</action> <!-- required -->
    <source>[SourceFile]</source> <!-- required -->
    <multijob_workflow>yes</multijob_workflow> <!-- optional -->
    <format>
        <output>[advanced_hls|advanced_dash|advanced_mss|fmp4_hls|advanced_fmp4]</output> <!-- required-->
        <destination>[DestFile]</destination> <!-- required -->
        <stream>
            <audio_only>yes</audio_only> <!-- required -->
            <align_audio_segments_to_framerate>[FrameRate]</align_audio_segments_to_framerate>
            <pack_audio_to_mpegts>yes</pack_audio_to_mpegts> <!-- optional-->
            <!-- stream params -->
        </stream>
        <stream>
            <!-- stream params -->
        </stream>
        <!-- format params -->
    </format>
</query>

{
    "query": {
        "userid": "<<id>>", // required
        "userkey": "<<key>>", // required
        "action": "[Action]", // required
        "source": "[SourceFile]", // required
        "multijob_workflow": "yes", // optional
        "format": {
            "output": "[advanced_hls|advanced_dash|advanced_fmp4]", // required
            "destination": "[DestFile]", // required
            "stream": [
                {
                    "audio_only": "yes", // required
                    "align_audio_segments_to_framerate": "[FrameRate]",
                    "pack_audio_to_mpegts": "yes" // optional
                    // stream params
                },
                {
                    // stream params
                }
            ]
            // format Params
        }
    }
}

Parameter	Description	Allowed Values	Default Value
align_audio_segments_to_framerate	Align audio segment count to framerate value. If it's value same as video framerate value audio and video manifests will have equal segments count.	Valid framerate string	none

🚧
For align_audio_segments_to_framerate
The <align_audio_segments_to_framerate /> is only available for advanced_hls, advanced_dash, and advanced_fmp4 output formats.
The <align_audio_segments_to_framerate /> only appliable if <audio_only /> set to yes in the <stream /> block.
For advanced_hls output format media should have <multijob_workflow /> set to yes, or <pack_audio_to_mpegts /> set to yes.