docs(spec/package): about sutera world yaml format

package/01-sutera-world-spec.md

@@ -0,0 +1,80 @@
+# ワールド
+
+sutera VR にアップロードするワールドの情報を記述します。
+現在ワールドは静的なオブジェクトに限定されています。
+
+## 情報
+
+### medatdata.type
+
+yaml の種類を記述します。
+
+### medatdata.name
+
+ワールドの名前を記述します。
+
+### medatdata.version
+
+ワールドのバージョンを記述します。
+
+## スペック
+
+### specs.spawn_point
+
+ユーザーがワールドに入場した際のスポーンポイントを記述します。
+
+### specs.border
+
+ワールドの境界を記述します。ここで設定された値を越えた際、ユーザーはリスポーンします。
+
+### specs.objects
+
+ワールドを構成するオブジェクトの情報を記述します。
+
+#### specs.objects.name
+
+オブジェクトの名前を記述します。
+
+##### specs.objects.model.type
+
+オブジェクトの形式を記述します。
+
+##### specs.objects.model.path
+
+オブジェクトが保存されているパスを記述します。
+
+#### specs.objects.material
+
+オブジェクトが利用するマテリアルの情報を記述します。
+
+##### specs.objects.material.type
+
+マテリアルの形式を記述します。
+
+##### specs.objects.material.path
+
+マテリアルが保存されているパスを記述します。
+
+#### specs.objects.location
+
+オブジェクトを配置する場所を記述します。
+
+#### specs.objects.rotation
+
+オブジェクトを配置する際の回転情報を記述します。
+
+#### specs.objects.scale
+
+オブジェクトを配置する際のスケーリング情報を記述します。
+
+#### specs.objects.physics
+
+オブジェクトの物理情報を記述します。
+
+##### specs.objects.colliders
+
+オブジェクトのコライダー情報を記述します。
+
+##### specs.objects.gravity
+
+オブジェクトの重力情報を記述します。

package/world.yaml

@@ -0,0 +1,48 @@
+metadata:
+  type: sutera-scene@0.1.0
+  name: sutera world
+  version: 0.1.0
+specs:
+  spawn_point:
+    x:
+    y:
+    z:
+  border: # 越えたらリスポーン
+    x_min:
+    x_max:
+    y_min:
+    y_max:
+    z_min:
+    z_max:
+  objects: # 配列
+    - name: sofa
+      model:
+        type: gltf
+        path: models/sofa.gltf
+      material:
+        type: sbsar
+        path: materials/sofa.sbsar
+      location:
+        x:
+        y:
+        z:
+      rotation:
+        x:
+        y:
+        z:
+        w:
+      scale:
+        x:
+        y:
+        z:
+      physics:
+        colliders:
+          - type: box
+        gravity:
+          mass: 5000
+    - name: ball # 最小構成
+      model:
+        type: sphere # 基本図形はgltfなしで可能
+      material:
+        type: diffuse_bsdf # 単色もファイルなしで可能
+        color: 0x6833cf