コンテンツにスキップ

HEOWorldSetting

HEOWorldSettingはワールドの基本設定を取りまとめるコンポーネントで、以下の設定を管理しています。

  • 基本情報
  • カメラ設定
  • 描画設定
  • アバター設定
  • マイアバター設定

基本設定

BasicInfo

名称 初期値 機能
World Name "world" ワールド名を設定する項目です。基本的にはワールド作成時に自動生成されたIDがアップロード時に自動入力され、URLなどに反映されます。
(例:[VketID_of_Creator].cloud.vket.com/worlds/[World_Name])
Debug Mode false デバッグモードを切り替えることができます。オンにするとブラウザ上でF1またはF2からデバッグ機能を使用することが可能になります。
Use Avatar Click true 他のプレイヤーをクリックした時に処理を利用するかどうかの設定です。
VRM Drop false ブラウザ上へのVRMドロップによるローカルの(他プレイヤーから見えない)アバター変更を許可します。
Occulusion Culling false オクルージョンカリングをオンにします。
詳しい使い方はオクルージョンカリングをご確認ください。 
World Name Directory false .heoファイルなどの出力時に、ワールド名の付いたフォルダにまとめます。
(例: data/field/ワールド名/world.heo)
Use GamePad false ゲームパッドを使用するかどうかの設定です。
Use Physics Engine false 物理エンジンを使用するかどうかの設定です。
Voice Attenuation true プレイヤー音声の距離減衰の有効/無効を切り替えます。
Min Distance (m) 5.0 減衰を開始する距離をメートル単位で指定します。
Max Distance (m) 10.0 減衰を終了する距離をメートル単位で指定します。
Favicon 空欄 Faviconを設定する項目です。
HeliScript 空欄 ワールド内で使用されるHeliScriptが一覧表示されます。HEOScriptなどで指定したHeliScriptは本項目にリストアップされます。

Note

HeliScriptは基本的には自動で項目が追加されますが、ファイルの削除などによって項目にNone(未指定)またはMissingが発生する場合があります。 HeliScriptの項目内がNone(未指定)またはMissingの状態はビルドエラーの原因になるため、ご注意ください。

HeliScriptMistake

Note

環境にゲームパッドが接続されている状態で`Use GamePad`が有効になっているワールドに入場すると、ゲームパッドによる操作が可能となります。<br>
使用するゲームパッドによって操作方法が異なる場合がありますが、基本的には以下の操作が可能です。<br>
なお、キー割り当ての変更/追加、ゲームパッドによるカメラ操作の反転については現バージョンでは非対応です。
名称 機能
左スティック アバター移動
右スティック カメラ操作
□ / X / Y  ジャンプ
R3(右スティック押し込み) カメラリセット(初期方向に戻る)

カメラ設定

Camera

名称 初期値 機能
Smoothing false カメラの上下の動きにスムージングをかけるかどうかを指定します。
Far Offset (y-axis) 0.0 TPSカメラの注視点を上下に調整できます。
Near Offset (y-axis) 0.0 TPSカメラの注視点を上下に調整できます。
Photo Radius 20.0 撮影モードカメラの移動可能半径を指定します。
Raycast Max Distance 50.0 クリック判定をおこなうカメラからの最大距離をメートル単位で指定します。
TPS Pitch Max Angle 6.0 TPSカメラの最大ピッチ角度を指定します。
ワールド内の設定の「アイレベル」にて「高い」を選択すると本設定の値が適用され、「普通」を選択すると半分の値が適用されます。
Default TPS Camera TPS Center TPSカメラのオフセットを指定できます。
ワールド内設定の三人称視点位置にて切り替えることができます。
TPS Center:真後ろright:右肩越し(一般的なTPSカメラ)left:左肩越し

描画設定

Rendering_1

名称 初期値 機能
PBR true PBRライティングをオンにします。
Directional Light 空欄 シーンに設置されたディレクショナルライトをワールドライトとして指定します。
Fade In Time 2.0  ワールド入場時のホワイトフェードインの時間を秒単位で指定します。
Shadow Type Round  影の描画方法を指定します。roundは 丸影、normalshadowmapは通常のシャドウマップです。
normalshadowmapHEOShadowと組み合わせて使用します。
Shadow Bias 0.001  影描画のバイアス値を設定します。
Shadow Area Size 3.0  シャドウを描画する距離をメートル単位で指定します。
Shadow Fade Size 1.0  シャドウ外周に向かってフェードアウトする距離をメートル単位で指定します。 
Projection Near 0.1 近傍のクリッピング距離を指定します。
Projection Far 500.0 遠方のクリッピング距離を指定します。
Projection Degree 70.0 画角を指定します。(デフォルト値推奨)
Bloom false ブルームのオンオフを切り替えます。
Light Scattering false ライトスキャッタリングのオンオフを切り替えます。
IBL false IBL(Image-Based Lighting)のオンオフを切り替えます。

Note

`Directional Light`に設定されているIntensityの値(下記画像参照)はワールドに反映されないためご注意ください。<br>
ライトの強弱は`LightColor`の色を`Directional Light`側の色と重ね合わせることで表現が可能です。

Rendering_2


Bloom / Light Scattering / IBL設定

Rendering_3

名称 初期値 機能
Bloom false ブルームのオンオフを切り替えます。
Bloom Intensity 0.2 ブルームの強さを設定します。
Bloom Threshold 0.8 ブルームの閾値を設定します。
Light Scattering false ライトスキャッタリングのオンオフを切り替えます。
Scattering Intensity 0.8 空気散乱強度を設定します。
Scattering Directivity 0.68 拡散指向性を調整します。
G 0.0 IBLの強さを調整するパラメータを設定します。
Distance 150.0 効果開始距離を設定します。
LightColor #FFFFFF ライトカラーを指定します。
SunColor #D9D9FF 太陽光色を設定します。
IBL false IBL(Image-Based Lighting)のオンオフを切り替えます。
DiffuseSize 512 ディフューズマップのサイズを指定します。
SpecularSize 512 スペキュラマップのサイズを指定します。
SpecularMipMapCount 6.0 スペキュラ用キューブマップのミップマップの数を指定します。

アバター設定

Avatars

名称 初期値 機能
Dummy Avatar dummy_human_02 遠方や描画制限がかかった場合に描画するダミーアバターを指定します。
Avatar Files Vketchan_v1.6_Mtoon_blendshape アバター情報をまとめたアバターファイルを指定します。アバターファイルについては、こちらをご覧ください。
CreateAvatarFile 新規のアバターファイルを生成します。

Note

HEOWorldSetting > Avatars > Avatar Fileにて空欄がある、Avatar Fileが1つも設定されていない場合はビルドエラーが発生したり初期状態のアバターが表示されない状態となります。

HEOWorldSetting_AvatarFileError_1

SDKでは初期状態のアバターとして用意しているAvatarFileがあるため、バージョンアップ後に空欄が発生している際はこちらをご利用ください。

HEOWorldSetting_AvatarFileError_2


マイアバター設定

MyAvatar_1

名称 初期値 機能
Use MyAvatar true プレイヤーがマイアバターを使用できるか否か設定します。
NSFW false NSFW(Not Safe For Work: 閲覧注意)なアバターの表示を制限します。
Polygon 50000 そのワールド内で使用できるマイアバターのポリゴン上限を指定します。
Motion マイアバターが使用するモーションを指定します。

Motion設定

名称 初期値 機能
Motion Name モーション名を設定します。
.hem モーション再生時に使用するアニメーションファイル(.hem)を指定します。
loop true アニメーションをループ再生するか設定します。
Use Action false モーション再生時に実行するアクションを設定します。
具体的には、本項目を有効にした上でSettingから実行するアクションを設定します。
.hemが空欄のモーションを追加することで、モーション再生時にパーティクルだけ再生する、といった用途等に利用できます。
Draw Circle Shadow true モーション再生時に丸影を描画するかどうか設定します。
Collision Detection true モーション再生時に衝突判定をおこなうかどうか設定します。

モーションについて

デフォルトで設定されているアニメーション及びモーション名はSDK側で使用しているモーションです。
アニメーションファイルを用意し差し替えることで待機・歩行などのマイアバターのアニメーションを差し替えることができます。
ワールドにて用意したプリセットアバターのアニメーションを設定するにはアバター設定にて指定したアバターファイルを編集します。


Emotion設定

MyAvatar_2

名称 初期値 機能
Emotion マイアバターが使用するエモートを指定します。
loop true アニメーションをループ再生するか設定します。
Use Action false エモーション再生時に実行するアクションを設定します。
具体的には、本項目を有効にした上でSettingから実行するアクションを設定します。

Objects設定

HEOWorldSetting_Objects

マイアバターにオブジェクト(.heoファイル、パーティクル、音声)を指定します。
3Dモデルを設定したい場合は .heoファイルへの変換が必要です。

名称 初期値 機能
Name 空欄 オブジェクトの名前を設定します。
Object Type Heo オブジェクトの種類を設定します。
Heo: .heoファイル, Hep: パーティクル,Audio: 音声
File 空欄 使用するファイルを指定します。
Position 0,0,0 Targetからの相対座標を指定します。
Rotation 0,0,0 Targetからの相対角度を指定します。
Target 空欄 Position及びRotationの基準となるボーン名を指定します。
ボーン名はVRMヒューマノイドのフォーマットに由来しており、記載する際はスネークケースにします(例: head, leftLowerLeg, leftThumbProximal...)