Formats and Presets 1.1:Special Flags/ru

From Aviberry API

Jump to: navigation, search

К содержанию
Возникли вопросы?


Существуют специальные флаги, которые формально не являются частью настроек профиля, но их можно добавлять в preset_data для получения нужного результата.

Contents

GenerateFLV

GenerateFLV - Специальный флаг, который применяется для смены контейнера из MPEG-4 в FLV без перекодирования. Исходный файл должен быть в формате MPEG-4 с видеокодеком H.264 и аудиокодеком AAC.
Тип: boolean.
Значение по умолчанию - false

Может принимать значения:

Значение Описание
false Использовать обычное перекодирование файла
true Сменить контейнер из MPEG-4 в FLV без перекодирования


Может использоваться:

  • При кодировании в формат FLV, если исходный файл в формате MPEG-4 с видеокодеком H.264 и аудиокодеком AAC;
  • При кодировании в формат MPEG-4 с видеокодеком H.264 и аудиокодеком AAC. В этом случае будет сгенерировано два файла - сначала MPEG-4, а затем, на его основе, без перекодирования, FLV. В этом случае, для корректной работы необходимо, чтобы параметр target_filename_policy был равен OVERWRITE_EXTENSION.

Примеры использования (XML-RPC)


<member>
    <name>format_id</name>
    <value><string>16505</string></value>
</member>
<member>
    <name>preset_id</name>
    <value><string>-2</string></value>
</member>
<member>
    <name>preset_data</name>
    <value><string>
        {"VideoCodec":"avc1","AudioCodec":"mp4a","Width":"320","Height":"180","FrameRate":"25",
        "VideoSAsInput":false,"PSPMode":false,"ProgressiveDownload":true,"ResizeMethod":"1","ResizeQuality":"1",
        "Frequency":"48000","Channels":"2",
        "VParams":{"H264":{"Profile":4,"Quality":2,"MaxIFrameInterval":25,"MaxBFrameSequence":0,"VBR":true,"AspectRatio":0}},
        "AParams":{"AAC":{"Profile":"2","Bitrate":"192000","Quality":"100"}},
        "GenerateFLV":true}
    </string></value>
</member>



<member>
    <name>format_id</name>
    <value><string>16509</string></value>
</member>
<member>
    <name>preset_id</name>
    <value><string>-2</string></value>
</member>
<member>
    <name>preset_data</name>
    <value><string>
        {"VideoCodec":"avc1","Width":320,"Height":240,"FrameRate":"25","VideoSAsInput":true,"ResizeMethod":1,"ResizeQuality":1,
        "IsSound":true,"AudioBitrate":128,"Frequency":44100,"Channels":2
        "VParams":{"H264":{"AvcC":true,"Profile":2,"Bitrate":-1,"Quality":0,"MaxIFrameInterval":125,"MaxBFrameSequence":0,"AspectRatio":0}},
        "GenerateFLV":true}
    </string></value>
</member>

SkipIfFileMatchesPreset

SkipIfFileMatchesPreset - Специальный флаг, который используется для проверки, нужно ли конвертировать файл. Если параметры исходного файла близки к заданным настройкам профиля, то он не конвертируется, а просто возвращается обратно пользователю.
Тип: boolean.
На данный момент этот флаг можно использовать только при конвертации в формат MPEG-4.
Значение по умолчанию - false.

Может принимать значения:

Значение Описание
false Файл всегда отправляется на конвертацию
true Пропускать конвертацию, если параметры исходного файла близки к заданным настройкам профиля


Параметры, которые сравниваются для проверки близости исходного файла и настроек профиля:

  • Video:
    • Если VideoSAsInput = false
      • Width
      • Height
      • FrameRate, с точностью до 0,01
    • Видеокодек (4CC-сигнатура)
    • Для кодека MPEG-4
      • Profile
      • Bitrate (если Bitrate != -1, т.е. не используется автоматический подбор битрейта), по умолчанию допускается расхождение до 100 кбит/с
      • AspectRatio, с точностью до 0,01
    • Для кодека H.263
      • Использование VBR или CBR
      • Bitrate (если VBR = false)
    • Для кодека H.264
      • Profile
      • Bitrate (если Bitrate != -1, т.е. не используется автоматический подбор битрейта), по умолчанию допускается расхождение до 100 кбит/с
      • AspectRatio, с точностью до 0,01
  • Audio
    • Channels
    • Frequency
    • Аудиокодек (4CC-сигнатура)
    • для кодека AAC
      • Profile
      • Bitrate, по умолчанию допускается расхождение до 10 кбит/с
    • для кодека AMR
      • Bitrate, по умолчанию допускается расхождение до 10 кбит/с
    • для кодека MP3
      • Bitrate, по умолчанию допускается расхождение до 10 кбит/с


Пример использования (XML-RPC)


<member>
    <name>format_id</name>
    <value><string>16505</string></value>
</member>
<member>
    <name>preset_id</name>
    <value><string>-2</string></value>
</member>
<member>
    <name>preset_data</name>
    <value><string>
        {"VideoCodec":"avc1","AudioCodec":"mp4a","Width":"320","Height":"180","FrameRate":"25",
        "VideoSAsInput":false,"PSPMode":false,"ProgressiveDownload":true,"ResizeMethod":"1","ResizeQuality":"1",
        "Frequency":"48000","Channels":"2",
        "VParams":{"H264":{"Profile":4,"Quality":2,"MaxIFrameInterval":25,"MaxBFrameSequence":0,"VBR":true,"AspectRatio":0}},
        "AParams":{"AAC":{"Profile":"2","Bitrate":"192000","Quality":"100"}},
        "SkipIfFileMatchesPreset":true}
    </string></value>
</member>

PreviewOffset

PreviewOffset - Специальный параметр, позволяющий задать смещение по времени для стоп-кадра.
Тип: integer.
Задается в миллисекундах.
Специальное значение -1 используется для получения стоп-кадра из середины видеофайла. Если значение PreviewOffset больше продолжительности видео, то стоп-кадр также будет взят из середины видеофайла. Может использоваться для любого выходного формата.

Пример использования (XML-RPC)


<member>
    <name>format_id</name>
    <value><string>16505</string></value>
</member>
<member>
    <name>preset_id</name>
    <value><string>-2</string></value>
</member>
<member>
    <name>preset_data</name>
    <value><string>
        {"VideoCodec":"avc1","AudioCodec":"mp4a","Width":"320","Height":"180","FrameRate":"25",
        "VideoSAsInput":false,"PSPMode":false,"ProgressiveDownload":true,"ResizeMethod":"1","ResizeQuality":"1",
        "Frequency":"48000","Channels":"2",
        "VParams":{"H264":{"Profile":4,"Quality":2,"MaxIFrameInterval":25,"MaxBFrameSequence":0,"VBR":true,"AspectRatio":0}},
        "AParams":{"AAC":{"Profile":"2","Bitrate":"192000","Quality":"100"}},
        "PreviewOffset":15000,
        "FormatId":"16505"}
    </string></value>
</member>

GetMediaInfo

GetMediaInfo - Специальный параметр, позволяющий получить информацию о медиафайле, полученном в результате конвертации.
Тип: string.
Задается в виде строки JSON, содержащей набор параметров, которые вы хотите получить.
Специальное значение GetMediaInfo=COMPLETE используется для получения всех данных.
Результат можно посмотреть после окончания конвертации при помощи метода getConversion.

Пример задания набора параметров: 

"GetMediaInfo":{"General":"VideoCount, Video_Format_List, AudioCount, Audio_Format_List","Video":"Width, Height","Audio":"Format, SamplingRate"}
Полный список параметров можно посмотреть здесь. Названия параметров регистрозависимы.

Может использоваться для любого выходного формата.

Пример использования (XML-RPC)


<member>
    <name>format_id</name>
    <value><string>16505</string></value>
</member>
<member>
    <name>preset_id</name>
    <value><string>-2</string></value>
</member>
<member>
    <name>preset_data</name>
    <value><string>
        {"VideoCodec":"avc1","AudioCodec":"mp4a","Width":"320","Height":"180","FrameRate":"25",
        "VideoSAsInput":false,"PSPMode":false,"ProgressiveDownload":true,"ResizeMethod":"1","ResizeQuality":"1",
        "Frequency":"48000","Channels":"2",
        "VParams":{"H264":{"Profile":4,"Quality":2,"MaxIFrameInterval":25,"MaxBFrameSequence":0,"VBR":true,"AspectRatio":0}},
        "AParams":{"AAC":{"Profile":"2","Bitrate":"192000","Quality":"100"}},
        "GetMediaInfo":"COMPLETE"}
    </string></value>
</member>


К содержанию
Возникли вопросы?

Retrieved from "http://api.aviberry.com/Formats_and_Presets_1.1:Special_Flags/ru"
Views
Personal tools
In other languages