タグ

タグ

各タグの仕様です。

フィールドの型は基本的な概念#オブジェクトとフィールドをご参照ください。 ただし、sequence<T>という表記は「各要素がT型の配列（sequence）」を表します。

オブジェクトの形状を表すタグ

cube, sphere, plane, cylinder

それぞれ立方体、球、平面、円柱を表す。

• 使用するフィールド：なし
• 使用するイベント：なし

model

3Dモデルファイルを使った任意形状の物体を表す。 モデルファイルはglTFのバイナリフォーマット（GLB形式）に対応。

• 使用するフィールド：

フィールド名	型	説明
model	blobHandle	モデルデータ（GLB形式）のBlob

• 使用するイベント：なし

text

文字列を表示する。 Unityのリッチテキスト記法を用いて太字や斜体などを設定することも可能。

• 使用するフィールド：

フィールド名	型	説明
text	string	表示する文字列
fontSize	int	文字サイズ
useRichText	int	リッチテキストを使用する場合はtrue（1）、使用しない場合はfalse（0）

• 使用するイベント：なし

mesh

フィールドの値を使用して任意の3Dメッシュを表現する。WASMを使用すれば、動的に変形する物体も表現可能。

• 使用するフィールド：

フィールド名	型	説明
vertices	sequence<vec>	各頂点の位置（ローカル座標系）
normals	sequence<vec>	各頂点の法線ベクトル（ローカル座標系）
indices	sequence<int>	三角形を構成する頂点番号の配列（要素数は3の倍数）

注：normalsフィールドは省略可（その場合は自動生成された法線ベクトルで描画される）。

• 使用するイベント：なし

line

いくつかの直線からなる折れ線を表す。

• 使用するフィールド：

フィールド名	型	説明
points	sequence<vec>	折れ線を構成する各点の位置（ローカル座標系）
width	float	線の太さ

• 使用するイベント：なし

外観・描画に関するタグ

material

オブジェクトのマテリアル（色など）を表す。

• 使用するフィールド：

フィールド名	型	説明
color	vec	色を表す3次元ベクトル。(R,G,B)の順番で、各成分は0.0～1.0の範囲。
alpha	float	不透明度（🚧現在は機能していないが、将来のために予約）
metallic	float	金属らしさ（値が大きいほど鏡面反射に物体の色が反映される）
smoothness	float	表面の滑らかさ（鏡面反射の鋭さ）
texture	blobHandle	テクスチャ（画像ファイル）のBlob

• 使用するイベント：なし

light

光源を表す。現在のところ、前述の形状を表すタグとは併用不可。

• 使用するフィールド：

フィールド名	型	説明
color	vec	発する光の色や強さを表す3次元ベクトル(R,G,B)
lightType	string	光源の種類。directional（太陽光のような平行光源）またはpoint（点光源）。

• 使用するイベント：なし

音に関するタグ

audioPlayer

音声ファイルに記録された音を再生する。 wav、mp3、ogg、aiff形式が使用可能。

• 使用するフィールド：

フィールド名	型	説明
audioFile	blobHandle	再生する音声ファイルのBlob
audioVolume	float	音量
audioPlaying	int	0は停止中、それ以外の値は再生中を表す。0以外の値を代入すると再生が開始される。
audioLoop	int	0以外の値であれば、再生終了後に繰り返し再生する。

動きに関するタグ

physics

オブジェクトが慣性や重力などの物理法則に従うことを表す。

• 使用するフィールド：

フィールド名	型	説明
velocity	vec	速度（ローカル座標系）
angularVelocity	vec	角速度（ローカル座標系。XYZ各軸の角速度をラジアン毎秒で）
mass	float	質量
isTangible	int	physicsタグが指定された際、自動的に1に設定される（colliderを参照）

• 使用するイベント：なし

collider

オブジェクトが衝突判定の対象であることを示す。

• 使用するフィールド：

フィールド名	型	説明
friction	float	摩擦係数
restitution	float	反発係数
isTangible	int	オブジェクトが「触れる」（触ってもすり抜けない）ことを示す（0以外であれば「触れる」）
isStatic	int	（🚧現在は機能していないが、将来のために予約）

constantVelocity

状態同期の際、オブジェクトが等速運動していると仮定して位置の予測を行う。

• 使用するフィールド：

フィールド名	型	説明
velocity	vec	速度（ローカル座標系）
angularVelocity	vec	角速度（ローカル座標系。XYZ各軸の角速度をラジアン毎秒で）

• 使用するイベント：なし