タグリファレンス
以下は、PlayCanvas Web Components で利用可能なタグの完全なリストです。
すべてのタグの属性は同じ値の規約を共有します。属性が存在しない(または削除された)場合はエンジンのデフォルト値が適用され、無効な値はコンソール警告をログに出力してデフォルト値にフォールバックします。Boolean、数値、列挙型、ベクトル、カラーの記述方法については属性を参照してください。
タグには配置ルールもあります。各タグのページに必要な親要素が記載されています。誤った場所に配置された要素は、受け付ける親要素の名前を含むコンソール警告をログに出力するため、オーサリング中はコンソールを開いておいてください。
エンジンのエンティティを表すタグは3つあり、コンポーネントタグはそのいずれの内側にも置けます。<pc-entity>、<pc-model>、<pc-node>です。つまり、モデルの内側に置いたコンポーネントはそのモデルに取り付けられ、ノードの内側に置いたコンポーネントはそのノードに取り付けられます。どちらもエンティティと同じコンポーネントの子を取ります。
pc-プレフィックスを外し、ハイフンを取り除くと、エンジンのコンポーネントIDになります。<pc-layout-group>はentity.layoutgroupを、<pc-rigid-body>はentity.rigidbodyを、<pc-audio-listener>はentity.audiolistenerを追加します。このルールは以下のすべてのコンポーネントタグで双方向に成り立つため、どちらの綴りも暗記する必要はありません。エンジンのIDが単語を続けて書くのは、それがハイフンを含められないJavaScriptのプロパティ名だからにすぎません。HTMLのタグにはその制約がありません。
繰り返し可能な子要素は、親のタグをプレフィックスとして取ります。<pc-anim>の中の<pc-anim-clip>、<pc-sound>の中の<pc-sound-slot>、<pc-script>の中の<pc-script-instance>です。
| タグ | 説明 |
|---|---|
<pc-anim> | アニメーションクリップを再生するアニメーションコンポーネントを定義します。 |
<pc-anim-clip> | アニメーションコンポーネントに割り当てる1つのクリップを定義します。 |
<pc-app> | アプリケーションのルート要素を定義します。 |
<pc-asset> | アプリケーションによってロードされるアセットを定義します。 |
<pc-audio-listener> | オーディオリスナーコンポーネントを定義します。 |
<pc-button> | ボタンコンポーネントを定義します。 |
<pc-camera> | シーンのレンダリングに使用されるカメラを定義します。 |
<pc-collision> | トリガーとリジッドボディによって使用される衝突コンポーネントを定義します。 |
<pc-element> | テキスト、画像、またはグループユーザーインターフェース要素を定義します。 |
<pc-entity> | エンティティを定義します。 |
<pc-gsplat> | 3D Gaussian Splats をレンダリングする gsplat コンポーネントを定義します。 |
<pc-joint> | 2つのリジッドボディを拘束する物理ジョイントを定義します。 |
<pc-layout-child> | レイアウトの子コンポーネントを定義します。 |
<pc-layout-group> | レイアウトグループコンポーネントを定義します。 |
<pc-light> | ライトコンポーネントを定義します。 |
<pc-material> | レンダーコンポーネントが参照できるマテリアルを定義します。 |
<pc-model> | GLBファイルから3Dモデルをインスタンス化するエンティティを定義します。 |
<pc-node> | 読み込まれたモデル内のノードにバインドしてオーバーライドします。 |
<pc-particle-system> | パーティクルシステムコンポーネントを定義します。 |
<pc-render> | レンダーコンポーネントを定義します。 |
<pc-rigid-body> | リジッドボディコンポーネントを定義します。 |
<pc-scene> | シーンを定義します。 |
<pc-screen> | 要素コンポーネントをレンダリングできるスクリーンコンポーネントを定義します。 |
<pc-script> | スクリプトコンポーネントを定義します。 |
<pc-script-instance> | スクリプトコンポーネントに割り当てられる単一のスクリプトを定義します。 |
<pc-scrollbar> | スクロールバーコンポーネントを定義します。 |
<pc-scroll-view> | スクロールビューコンポーネントを定義します。 |
<pc-sky> | 画像ベースのスカイボックスを定義します。 |
<pc-sound> | サウンドコンポーネントを定義します。 |
<pc-sound-slot> | サウンドコンポーネントに割り当てられる単一のサウンドを定義します。 |
<pc-wasm> | WebAssemblyモジュールを定義します。 |