B3ML 2.0 　 RealVoice 1.0 SPECIfication

Ryoichiro Debuchi / atom Co., Ltd.

2004/8/20

Bot3D 2.0 / B3ML 2.0で新たに定義するストーリー関連ファイル、RealVoice 1.0は、この中の要素タグを出現順に時系列で解析/実行していくものである。

会話音声に対応したリップシンクデータ列（口形要素）をベースに、キャラクターの表情/動作タグをモーラ単位で任意の時間位置に挿入可能であり、さらに、視覚表現をコントロールするタグ、modelFunction/globalFunctionも定義されている。

ここでは、Bot3D 2.0 / B3ML 2.0 ストーリー関連ファイル RealVoice 1.0のデータ形式の概要を述べる。

1.1 RealVoice 1.0ファイルのXML形式

<?xml version="1.0"?>
<!DOCTYPE Sentence SYSTEM "http://www.atom.co.jp/bot/dtd2/RealVoice.dtd">
<RealVoice>　--- 会話文章設定
					version="1.0" --- バージョン情報
<visumeFile/> --- 対応Visumeファイル
					url=”” --- ファイル名
<samplingRate /> ---WAVEファイルのサンプリングレート
		value="11025" --- サンプリングレート(Hz)
<Utterance>--- ひとつの会話文の定義
		name="" --- この会話文に名前を付ける
					<duration /> --- 音声ファイル再生時間
							value="0" --- 再生時間（ms）
					<Mora > --- モーラ記号
						(要素の内容)---モーラ記号列　：各モーラ記号は　”,”(コンマ)で区切る。
						<action(a) /> --- キャラクターモデルの動作(ボーン)アニメーションを行わせる
								motion(m)="" --- 動作（アニメーション）名
								duration(d)="0" --- 動作期間（秒）: これがある場合、デフォルト設定に優先
								grad(g)="0" --- 遷移期間（秒）: 動作終了前に別動作イベントがあった場合の動作移行期間
						<resetAction(ra) /> --- キャラクターモデルの動作姿勢のリセット
								duration(d)="0" --- 動作期間（秒）: これがある場合、デフォルト設定に優先
						<emotion(e) /> ---キャラクターモデルの表情（ターゲットモーフ）アニメーションを行わせる
								morph(m)="" 表情（モーフ）名
								duration(d)="0" --- モーフ期間（秒） : これがある場合、デフォルト設定に優先
								sensibility(s)="1" --- モーフ変化強度
						<resetEmotion(re) /> ---キャラクターモデルの表情モーフのリセット
								duration(d)="0" --- モーフ期間（秒） : これがある場合、デフォルト設定に優先
			</Mora>
			<HMora> --- ひらがなモーラ記号
						(要素の内容)---モーラ記号列　：各モーラ記号は　”,”(コンマ)で区切る。
				</HMora>
					<Text>
							（要素の内容）--- スーパー表示テキスト(Shift-JIS)
					</Text>
					<number /> --- モーラ単位の数
							value=”0” --- 整数
					<timing /> ---各モーラ単位に対応した時間長
						value=”0” ---時間長(ms)：各時間長は　”,”(コンマ)で区切る。各モーラに対応した時間長。
					<sound />---この文章に関連する音声ファイル
							url="NONE" --- 音声ファイル名:使用しない場合は url="NONE"と記述
</Utterance>
--- modelFunction関連 ---
<moveModel /> --- キャラクターモデルの位置変更
	tx="0" --- 新しいキャラクター位置： X座標
	ty="0"　--- Y座標
	tz="0"　--- Z座標
	rx="0"　 --- 新しいキャラクター回転（度）： X回転値
	ry="0"　--- X回転値
	rz="0"　--- Z回転値
	scale="1" --- 新しいキャラクタースケール
<moveToModel /> --- キャラクターモデルを移動させる
	tx="0" --- 新しいキャラクター位置： X座標
	ty="0"　--- Y座標
	tz="0"　--- Z座標
	rx="0"　 --- 新しいキャラクター回転（度）： X回転値
	ry="0"　--- Y回転値
	rz="0"　--- Z回転値
	scale="1" --- 新しいキャラクタースケール
	duration="0" --- 現在位置から移動完了までの時間（秒）
<doRotate /> --- キャラクターモデルの連続回転
	drx="0" --- 回転角度(度)/秒 :X値
	dry="0"　--- Y値
	drz="0"　--- Z値
<stopRotate /> --- キャラクターモデルの連続回転を止める
<resetRotate /> --- キャラクターモデルの回転値をリセットする
<doTranslate /> --- キャラクターモデルの連続移動
	dtx="0" --- 移動量/秒 :X値
	dty="0"　--- Y値
	dtz="0" --- Z値
<stopTranslate /> --- キャラクターモデルの連続移動を止める
<resetTranslate /> --- キャラクターモデルの移動値をリセットする
<resetModel /> --- キャラクターの位置（回転/スケール含む）をリセットする
<visibleModel /> --- キャラクターモデルの表示/非表示
	visible="ON"　--- 表示/非表示(ON/OFF または、TRUE/FALSE)
<toggleModel /> --- キャラクターモデルの表示/非表示を切り替える
<visibleParts />(*) --- キャラクターモデルのパーツの表示/非表示
	parts=" " --- 影響するパート名
	visible="ON" --- 表示/非表示(ON/OFF または、TRUE/FALSE)
<toggleParts />(*) --- キャラクターモデルのパーツの表示/非表示を切り替える
	parts=" " --- 影響するパート名
<setTexture />(*) --- キャラクターモデルのパーツのテクスチャを変える
	parts=" " --- 影響するパート名
	id="0" --- テクスチャID
--- globalFunction関連 ---
<backColor /> --- 背景色の設定
	red="0" --- 背景色 :red値
	green="0" --- green値
	blue="0" --- blue値
	duration="0" --- この期間(秒)で、現在の色から変更される
<loadBackImage /> --- 背景2D画像の設定
	url="" ---画像ファイル名
	name=" " ---この背景画像に名前を付ける
	tz=”1000” --- 画像位置 :Z座標
	visible="ON" ---表示/非表示(ON/OFF または、TRUE/FALSE)
<backImage /> --- 背景2D画像の操作
	name=" "　--- 背景名
	switch="ON" --- ONは表示する/OFFは消す (ON/OFF or TRUE/FALSE)
	fade="OFF" --- フェードイン/アウトさせるか (On/OFF or TRUE/FALSE)
	duration="0" --- フェードイン/アウト期間（秒）
<loadBackMovie />(*) --- 背景ムービーの設定
	url=" "　---ムービーファイル名
	name=" " --- この背景ムービーに名前を付ける
	tz=”1000” --- 画像位置:Z座標
	visible="ON" ---表示/非表示(ON/OFF または、TRUE/FALSE)
<backMovie />(*) ---背景ムービーの操作
	name=" " --- 背景ムービー名
	fps="30" --- プレイバックスピード :フレーム/秒
	loop="OFF" --- ループさせるか (ON/OFF or TRUE/FALSE)
	switch="ON" --- ONは表示する/OFFは消す(ON/OFF or TRUE/FALSE)
	fade="OFF" --- フェードイン/アウトさせるか(ON/OFF or TRUE/FALSE)
	duration="0" --- フェードイン/アウト期間（秒）
<stopBackMovie />(*) --- ループ表示されている背景ムービーを止める
	name=" " --- 背景ムービー名
<setLight /> --- 光源設定
	id="0" ---光源のＩＤ
	type="POINT" --- 光源のタイプ :POINT=点光源
	px="0" --- 光源の位置：X座標
	py="0"--- Y座標
	pz="0"--- Z座標
	red="1"　---光源の色：red値
	green="1" --- green値
	blue="1"--- blue値
	switch="ON" --- 光源の表示/非表示(ON/OFF or TRUE/FALSE)
<lightPos /> --- 光源を現在の位置から移動させる
	id="0" --- 光源のＩＤ
	px="0" --- 新しい光源の位置：X座標
	py="0" --- Y座標
	pz="0"--- Z座標
	duration="0" --- 移動期間（秒）
<lightColor /> --- 光源を現在の色から変える
	id="0" --- 光源のＩＤ
	red="1"　--- 新しい光源の色：red値
	green="1"--- green値
	blue="1""--- blue値
	duration="0" --- 遷移期間（秒）
<viewAngle /> --- 画角設定
	angle="45" --- 画角（度）
	front="1"　--- 前面クリップ位置
	back="1000"　--- 背面クリップ位置
	duration="0"　--- 現在の設定からの変更期間（秒）
<world /> --- ワールド座標
	tx="0" --- 平行移動値:X座標
	ty="0"--- Y座標
	tz="0""--- Z座標
	rx="0"　--- 回転値：X回転値
	ry="0"--- Y回転値
	rz="0""--- Z回転値
	duration="0"　--- 現在の設定からの変更期間（秒）
<loadSE />(*) ---効果音の設定
	url=" " --- サウンドファイル名
	name=" " ---この音に名前を付ける
<soundEffect />(*) --- 効果音の操作
	name=" " --- 効果音の名前
	loop="OFF" --- ループさせるか(ON/OFF or TRUE/FALSE)
	volume="1" --- 音量
	switch="ON" --- ONは鳴らし始める/OFFは鳴らすことをやめる(ON/OFF or TRUE/FALSE)
	fade="OFF" --- フェードイン/アウトさせるか(ON/OFF or TRUE/FALSE)
	duration="0" --- フェードイン/アウト期間（秒）
</RealVoice>

(*)--- 定義のみ未対応

<action(a) /> --- 等は、<action>,<a>が同等の意味を持つことを示す。（alias定義）

(注1) modelFunction/globalFunction関連タグは<Utterance>と同レベルで扱うが、将来的には、<Mora>タグ内記述できるようにする。

(注２) <emotion>/<action>/<resetEmotion>/<resetAction>タグは、将来的には、<Text>タグ内記述に対応できるようにする。

1.2 サンプルRealVoiceファイル

<?xml version="1.0" encoding="Shift_JIS"?>

<!DOCTYPE RealVoice SYSTEM "http://www.atom.co.jp/bot/dtd2/RealVoice.dtd">

<Text>こんにちは。私の名前はカエデ。</Text>

</Utterance>

<Text>今日は、宮沢賢治の小さな童話、銀杏の実をご紹介いたしましょう。</Text>

</Utterance>

</RealVoice>

戻る

B3ML 2.0 RealVoice 1.0 SPECIfication

1.1 RealVoice 1.0ファイルのXML形式

1.2 サンプルRealVoiceファイル

B3ML 2.0 　 RealVoice 1.0 SPECIfication