Release NotesUser InterfaceSystem Status
Recent API Changes
Back to All

03 June 2021

over 3 years ago by Encoding.com Product Team #2

Mainconcept Broadcast MXF parameters

Added several parameters for mainconcept_mxf output format.

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>AddMedia</action>
    <source>[SourceFile]</source> <!-- required-->
    <format> <!-- required -->
        <output>mainconcept_mxf</output> <!-- required -->
        <mxf_aes3_audio_frame_wrapping>[yes|no]</mxf_aes3_audio_frame_wrapping>
        <mxf_company_name>[CompanyName]</mxf_company_name>
        <mxf_product_name>[ProductName]</mxf_product_name>
        <mxf_product_version>[ProductVersion]</mxf_product_version>
        <!-- format params -->
    </format>
</query>

{
    "query": {
        "userid": "<<id>>", // required
        "userkey": "<<key>>", // required
        "action": "AddMedia", // required
        "source": "[SourceFile]", // required
        "format": { // required
            "output": "mainconcept_mxf", // required
            "mxf_aes3_audio_frame_wrapping": "[yes|no]",
            "mxf_company_name": "[CompanyName]",
            "mxf_product_name": "[ProductName]",
            "mxf_product_version": "[ProductVersion]"
            // format params
        }
    }
}
ParameterDescriptionAllowed ValuesDefault Value
mxf_aes3_audio_frame_wrappingUse AES3 audio frame-wrapping if <mxf_profile /> or <mxf_multiplex_type /> weren't specifiedyes, nono
mxf_company_nameMXF encoded application company nameString. Max length – 31 characters.none
mxf_product_nameMXF encoded application product nameString. Max length – 31 characters.none
mxf_product_versionMXF encoded application product versionString. Max length – 15 characters.none

Hide Encoding Settings for libx264 video codec

Added option to hide encoding settings from h264 bitstream .

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
    <source>[SourceFile]</source> <!-- required-->
    <format>
        <output>[OutputFormat]</output> <!-- required-->
        <video_codec>libx264</video_codec>
        <video_codec_parameters>
            <hide_encoding_settings>[yes|no]</hide_encoding_settings>
            <!-- video codec parameters -->
        </video_codec_parameters>
    </format>
</query>

{
    "query": {
        "userid": "<<id>>", // required
        "userkey": "<<key>>", // required
        "action": "[Action]", // required
        "source": "[SourceFile]", // required
        "format": {
            "output": "[OutputFormat]", // required
            "video_codec": "libx264",
            "video_codec_parameters": {
                "hide_encoding_settings": "[yes|no]"
                // video codec parameters
            }
        }
    }
}
ParameterDescriptionAllowed ValuesDefault Value
hide_encoding_settingsRemove encoding settings from h264 bitstreamyes, nono

New Metadata parameters

Added ability to set Broadcasting Service Name and Broadcasting Service Provider in output metadata.

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
    <source>[SourceFile]</source> <!-- required-->
    <format>
        <output>[OutputFormat]</output> <!-- required-->
        <metadata>
            <service_name>[ServiceName]</service_name>
            <service_provider>[ServiceProvider]</service_provider>
            <!-- metadata params -->
        </metadata>
    </format>
    <!-- Format params -->
</query>

{
    "query": {
        "userid": "<<id>>", // required
        "userkey": "<<key>>", // required
        "action": "[Action]", // required
        "source": "[SourceFile]", // required
        "format": {
            "output": "[OutputFormat]", // required
            "metadata": {
                "service_name": "[ServiceName]",
                "service_provider": "[ServiceProvider]"
                // metadata params
            }
            // format params
        }
    }
}
TagDescriptionAllowefd ValuesDefault Value
service_nameBroadcasting Service NameStringnone
service_providerBroadcasting Service Provider NameStringnone

Container ID parameters

Added option to set transport stream id for mpegts output format and stream id mapping for all formats.

<?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 -->
        <stream_id_mapping>[IDMapping]</stream_id_mapping>
        <transport_stream_id>[TsID]</transport_stream_id>
        <!-- format params -->
    </format>
</query>

{
    "query": {
        "userid": "<<id>>", // required
        "userkey": "<<key>>", // required
        "action": "addMedia", // required
        "source": "[SourceFile]", // required
        "format": {
            "output": "[output]", // required
            "stream_id_mapping": "[IDMapping]",
            "transport_stream_id": "[TsID]"
            // format params
        }
    }
}
ParameterDescriptionAllowed ValuesDefault Value
stream_id_mappingContainer stream id metadata mappingComma separated list of id pairs separated by colon.
E.g
[SourceID_1]:[OutputID_1],[SourceID_2]:[Output_ID2]		none
transport_stream_idMPEG-TS Transport Stream IDHex numbernone

🚧

For transport_stream_id

<transport_stream_id /> parameter available only for mpegts output format.

AAC Audio Profile

Added ability to set AAC Audio Profile.

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>addMedia</action>
    <source>[SourceFile]</source>
    <format> <!-- required -->
        <output>[output]</output> <!-- required -->
        <audio_codec>libfdk_aac</audio_codec>
        <audio_profile>[AACProfile]</audio_profile>
        <!-- format params -->
    </format>
</query>

{
    "query": {
        "userid": "<<id>>", // required
        "userkey": "<<key>>", // required
        "action": "[Action]", // required
        "source": "[SourceFile]", // required
        "format": {
            "output": "[output]", // required
            "audio_codec": "libfdk_aac",
            "audio_profile": "[AACProfile]"
            // format params
        }
    }
}
ParameterDescriptionAllowed ValuesDefault Value
audio_profileAAC audio profileaac_low, aac_he, aac_he_v2, aac_ld, aac_eldnone

🚧

For audio_profile

<audio_profile /> parameter works only with libfdk_aac audio codec.