profile.xml 簡易説明書

このメモは、profiles.xmlの概要と、簡単な編集の仕方を説明します。 profiles.xmlは，ubicast Producerがエンコードする時の，エンコードパラメータやサイズなどの設定を記述するファイルです。

構成

ファイルの構成

profiles.xmlは、プロファイルのリスト構造になっています。

1つのプロファイルの構成は以下のようなプロパティの集合です。

- <properties name="large">
<property name="filetype" value="0" />
<property name="stereo" value="yes" />
<property name="displayName" value="大 - 320x240 (4:3)" />
<property name="resize" value="yes" />
<property name="width" value="320" />
<property name="height" value="240" />
+ <properties name="high-compress">
+ <properties name="normal-quality">
+ <properties name="high-quality">
</properties>

この例ではストリームは3つ(high-compress, normal-quolity, high-quality)含んでいます。出力されるv1,v2,v3の順番でストリームを記述する必要があります。低帯域用のものから、先に書くようにしてください。

filetype は、出力形式を指定します。(0: vN形式, 1: 1ファイル形式) stereoは、noの場合、強制的にモノラルにするオプションです。 resize はyesにしておいてください。

1つのストリームの構成は以下のようなプロパティの集合です。

- <properties name="high-compress">
<property name="displayName" value="高圧縮" />
<property name="displayBitrate" value="150Kbps" />
<property name="shortName" value="150k" />
<property name="videoBitRate" value="110" />
<property name="videoFrameRate" value="5" />
<property name="audio1BitRate" value="24" />
<property name="audio2BitRate" value="32" />
<property name="audio2SampleBits" value="16" />
<property name="audio2SamplesPerSec" value="22050" />
<property name="audio2Channels" value="2" />
</properties>

audio2Channels=1の場合は、audio2Channels以外のaudio2XXXXの項目は使用されません。

shortNameは、以前までは、クリップ一覧のサムネイルの横に選択されたストリームの名前として表示されてましたが、今はdisplayNameのほうを表示しています。

<properties>の参照

<properties>という要素は、プロパティの集合を含むことを表しますが、 ref-idというアトリビュートを使用することで、他の場所で定義された<properties>を参照することができます。

- <properties name="A">
<property name="foo" value="bar" />
</properties>
<properties name="B" ref-id="./A" />

こうすると、プロパティ集合Bの中身は、Aの中身と同じように扱われます。各サイズのワイド版プロファイルは、4:3版のプロファイルとほとんど同じなので、参照を使って、記述を省略してます。

- <properties name="medium-wide">
<property name="filetype" value="0" />
<property name="stereo" value="1" />
<property name="displayName" value="中 - 240x128(16:9)" />
<property name="resize" value="yes" />
<property name="width" value="240" />
<property name="height" value="128" />
<properties name="high-compress" ref-id="../medium/high-compress" />
<properties name="normal-quality" ref-id="../medium/normal-quality" />
<properties name="high-quality" ref-id="../medium/high-quality" />
</properties>

この場合、各ストリームは medium のストリームを参照しています。

追加/編集

ストリームの追加

あるプロファイルに、ストリームを追加するには、以下の記述をプロファイル内に挿入するだけです。

<properties name="{stream-id}">
<property name="displayName" value="{名前}"/>
<property name="displayBitrate" value="{表示ビットレート}"/>
<property name="shortName" value="{表示ビットレート}"/>
<property name="videoBitRate" value="110"/>
<property name="videoFrameRate" value="5"/>
<property name="audio1BitRate" value="24"/>
<property name="audio2BitRate" value="32"/>
<property name="audio2SampleBits" value="16"/>
<property name="audio2SamplesPerSec" value="22050"/>
<property name="audio2Channels" value="2"/>
</properties>

{stream-id}は、同じプロファイル内でかぶらないようにして、他のプロファイル内の似たストリームと同じIDにするとよいとおもいます。

注意!!

v1, v2, v3などが出力される順序は、このストリームを記述する順序に依存するので注意する必要があります。低帯域のものを先のほうに挿入するようにしてください。

プロファイルの追加

新たなサイズを定義する場合なんかは、新たにプロファイルを作る必要があります。ストリームは他のプロファイルのものを流用して、サイズのみ定義しなおす場合は、参照を利用して以下のように記述できます。

<properties name="large-wide">
<property name="filetype" value="0"/>
<property name="stereo" value="1"/>
<property name="displayName" value="大 - 320x176 (16:9)"/>
<property name="resize" value="yes"/>
<property name="width" value="320"/>
<property name="height" value="176"/>
<properties name="high-compress" ref-id="../large/high-compress"/>
<properties name="normal-quality" ref-id="../large/normal-quality"/>
<properties name="high-quality" ref-id="../large/high-quality"/>
</properties>

これは、大サイズのワイド版の例です。ストリームは、大の4:3版のものを使っています。ストリームをそれぞれ定義しなおす場合は、該当個所を上書きすればOKです。プロファイルを挿入する順序は、クリップのプロパティで、「サイズ」のコンボボックスに表示される順序に影響されます。