Qiita Engineer Festa20242024年7月17日まで開催中！

VRC Worldで～したいときの方法

Last updated at 2024-08-27Posted at 2024-06-26

徐々に書き足します。

worldを～したい

worldを作成したい

Creator Companionをダウンロードして、指示に従うと、床だけあるworldが出来る。
基本的には下のページの「VCCによる環境構築(Unity)」を行えばOK(バージョン違いかちょっと画面違うところもあるけど)

VCC起動
右上の「Create New Project」をクリック
左上の「Unity 2022 World Project」をクリック & Project名・保存場所を入力して、「Create Project」をクリック
"Manage Packages"と書かれた画面になるので、必要に応じて"Latest Version"列の"↑(数字)"を押して、パッケージを最新版にする。
「Open Poject」を押すと、Unityが起動して、床だけのワールドが表示される。

worldをアップロードしたい

上のメニューバーの「VRChat SDK」>「Show Control Panel」とクリック
(場合によっては聞かれるので)VRChatアカウントのID・PWを入力。2段階認証コードも聞かれるので入力
"Builder"タブをクリック
ワールド名他必要な情報を入力し、Thumbnailも設定
一番下の"Online Publishing"の"The information ～"横の□にチェックを入れる
「Build and Upload」をクリックして待つ。

"World Visibility"の「Publish to Community Labs」を押すと公開されるので注意

オブジェクトを～したい

オブジェクトを置きたい

"Hierarchy"ウィンドウ内で右クリック > "3D Object" > (置きたいオブジェクトの種類(e.g. Cube(直方体)/Sphere(球体)/Plane(板) etc...) をクリックする

オブジェクトをグループ化して動かしたい

"Hierarchy"ウィンドウ内で右クリック > "Create Empty" > をクリックする
出来た"GameObject"にグループ化して動かしたいオブジェクトをD&Dする

オブジェクトを反転させたい

"Inspector"ウィンドウの"Transform"の"Scale"のX,Y,Zの値を1→-1に書き換える

【参考】

オブジェクトを整列したい/均等に並べたい

"Inspector"ウィンドウの"Transform"の"Position"に"L(a,b)" (a,bは開始、終了の値)と入れる

【参考】

オブジェクトをぴったりくっつけたい

移動したいオブジェクトを選択し、"V"キーを押しながら、頂点にマウスを持っていくと□が出るので、くっつけたい頂点にD&Dする

オブジェクトを拾えるようにしたい

"Hierarchy"ウィンドウで当該オブジェクトを選択(Ctrlで複数選択も可能)
右側の"Inspector"ウィンドウの「Add Component」をクリック
入力欄に"VRC Pickup"と入れ、"Search"下部の"VRC Pickup"をクリック
必要に応じて"VRC Pickup"内の下記設定を変更する。
- Use Text : 手を近づけたときに、出てくるテキストの設定
- Proximity : どれくらい手を近づけると、拾えるようにするか
- Pickupable: 拾えるようにするか否か。
- Disallow Theft : 既に誰かが拾っているのを奪えるようにするか否か。
上記を実施しても拾えない場合は"Colider"の追加を行う。
1. 右側の"Inspector"ウィンドウの「Add Component」をクリック
2. 入力欄に"Box Colider"と入れ、"Search"下部の"Box Colider"をクリック
3. 必要に応じて、"Center"や"Size"を調整する。

オブジェクトが落ちるようにしたい(重力を効かせたい)

(右側の"Inspector"ウィンドウ内に"Rigidbody"がなければ)"Rigidbody"の追加
"オブジェクトを拾えるようにしたい"の"VRC Pickup"を"Rigidbody"と読み替えて作業
"Rigidbody"内の"Use Gravity"にチェックを入れる
必要に応じて"VRC Pickup"内の下記設定を変更する。
- Mass : 物体の質量

【参考】

オブジェクトの物理演算を無効/有効にしたい

(右側の"Inspector"ウィンドウ内に"Rigidbody"がなければ)"Rigidbody"の追加
"オブジェクトを拾えるようにしたい"の"VRC Pickup"を"Rigidbody"と読み替えて作業
"Rigidbody"内の"Is Kinematic"を物理演算無効にしたいならチェック有 / 有効にしたいならチェック無にする
必要に応じて"VRC Pickup"内の下記設定を変更する。
- Drag : オブジェクトにかかる抵抗
- AngularDrag : オブジェクトの回転にかかる抵抗

なので机とか床に固定しておきたいものはIs Kinematicのチェックを入れる。
Is Kinematicチェック有 & PickUp有を入れてると、オブジェクトを離したときにその場に留まる
"Use Gravity"にチェック有でも、"Is Kinematic"にチェック有だと、落ちなくなる
オブジェクトを離した後、空中でほわーんと動かしたい場合に"Is Kinematic"のチェック無 & "Use Gravity"は無 & Drag・AngularDragを動かしたい時間の逆数で入力(0にすると動き続ける)

【参考】

オブジェクト同士がぶつかるようにしたい/すり抜けるようにしたい

"clolider"を追加する。

オブジェクトとアバターがぶつかるようにしたい

オブジェクトに色を付けたい

マテリアルの作成
1. メニューバーの "Assets" > "Create" > "Material" の順にクリック
2. "New Material"が出来るので、必要に応じて名前を変更する。
  　 (あとから変えたくなったら、右クリックして"Rename")
3. 右側の"Inspector"ウィンドウ内の"Albedo"の白色をクリックする
4. "Color"ウィンドウが出てくるので、好きな色に調整
他にもMaterialで質感変えたりとか発光させたりとかいろいろできるっぽい。
マテリアルの適用
1. "Assets"内にある適用したい色のボール(Material)を、"Scene"上の適用したいObjectにドラッグアンドドロップ

【参考】

オブジェクトに画像を表示したい

マテリアルの作成
1. 「オブジェクトに色を付けたい」の1の2までと同じ手順を行う
2. 画像を下方の"Assets"内にドラッグアンドドロップする。
3. 右側の"Inspector"ウィンドウ内の"Shader"を"Legacy Shader" > "Diffuse"とクリックして変更する(このShaderじゃなくてもいいっぽい?)
4. 右側の"Inspector"ウィンドウ内の"None (Texture)"に2.で追加した画像をドラッグアンドドロップする
マテリアルの適用
「オブジェクトに色を付けたい」の２を参照

Planeの表裏で別の画像を表示したい

Plane：板状のオブジェクト。Shaderを改造する。

Shaderを改造する
1. 下方の"Assets"内で右クリック、"Create" > "Shader" > "Unlit Shader" とクリック。
2. "NewUnlitShader"が出来るので必要に応じて名前変更する。(今回は"reverseible.shader"とする。)
  (あとから変えたくなったら、右クリックして"Rename")
3. 初回or設定しないと、「何のソフトで開く?」と聞いてくるので、適切なソフトを選んで「常に使う」をクリック。
  (VS Codeとか、メモ帳とか適当なテキストエディタでOK)
4. 参考にしたサイトの「続いて作成したreversible.shaderに次のプログラムを入力してください。」以下のコードに書き換え
```
Shader "Unlit/reversible"
{
    Properties
    {
        _MainTex ("Texture", 2D)    = "white" {}
        _MainTex2("Texture2", 2D) = "white"{}
    }
    (略)
    }
}
```
5. Ctrl + Sとかで上書き保存して、テキストエディタを閉じる。
改造したShaderを適用する
1. "Scene"上もしくは"Hierarchy"ウィンドウで、「オブジェクトに色を付けたい」or「オブジェクトに画像を表示したい」で設定したオブジェクトを選択
2. "Inspector"ウィンドウで"～～(Material)"と書いてある下の"Shader"で、"Unlit" > "reverseible.shader"と選択。
3. 右側の"Inspector"ウィンドウ内の"None (Texture)"2か所に表/裏にしたい画像をドラッグアンドドロップする

【参考】

UIを～したい

UIを作成したい

"Hierarchy"ウィンドウで右クリック > "UI" > "Canvas" とクリック。"Hierarchy"ウィンドウで"Canvas"が生成される。
"Inspector"ウィンドウの上の方にある"Layer"を"UI"から"Default"に変更
"Inspector"ウィンドウの真ん中ら辺にある"Canvas"内の"Render Mode"を"Screen Space - Overlay"から"World Space"に変更
デカすぎてやりずらいので大きさと位置、スケールを修正する。
"Inspector"ウィンドウの上の方にある"Rect Transform"の"Pos X"を0,"Pos Y"を2,(多分、Canvasの中心位置設定?)、"Width","Height"(多分、Canvasの大きさ設定?)をともに200、"Scale"のX,Y値を0.01くらいにする。
UI要素を追加する。"Hierarchy"ウィンドウで"Canvas"を右クリック > "UI" > 追加したいUI要素(e.g. "Button - TextMeshPro" / "Toggle" etc...)
ボタンなど操作するものについては"add component"で"VRC UI Shape"を付ける。

【参考】

UIのボタンで～したい

"～したい"の部分をメソッドで書いておいて、ボタンのOnClickで呼ぶ、

「UIを作成したい」を参考にUIを作成する。"VRC UI Shape"を付けるのを忘れないこと。

「Udon Sharpを使いたい」などを参考にUdonSharpを記述する。
今回はボタンを押すと、数値が増加し、テキストに反映されるようにしてみる。
意味の解説は「UdonSharpで同期したい」を参照。

using UdonSharp;
using UnityEngine;
using UnityEngine.UI;
using VRC.SDKBase;
using TMPro; // TextMeshProを使う場合はこれが必要

[UdonBehaviourSyncMode(BehaviourSyncMode.Manual)]
public class UI : UdonSharpBehaviour
{
    private const string DEFAULT_STATE_NAME = "Init";
    [SerializeField] public TextMeshProUGUI _boolLabel;
    [SerializeField] public TextMeshProUGUI _intLabel; 

    [UdonSynced, FieldChangeCallback(nameof(BoolData))] 
    private bool _boolData;

    [UdonSynced, FieldChangeCallback(nameof(IntData))] 
    private int _intData;

    public bool BoolData
    {
        get => _boolData;
        set
        {
            _boolData = value;

            // 実際の処理
            _boolLabel.text = $"bool: {_boolData}";
        }
    }

    public int IntData
    {
        get => _intData;
        set
        {
            _intData = value;

            // 実際の処理
            _intLabel.text = $"int: {_intData}";
        }
    }

    public void ToggleBool()
    {
        // 同期変数変更するためのオーナー譲渡
        SetOwner();

        // 値変更
        BoolData = !BoolData;
        RequestSerialization();
    }

    public void AddInt()
    {
        // 同期変数変更するためのオーナー譲渡
        SetOwner();

        // 加算処理
        IntData++;
        RequestSerialization();
    }

    public void DecInt()
    {
        // 同期変数変更するためのオーナー譲渡
        SetOwner();

        // 加算処理
        IntData--;
        RequestSerialization();
    }

    private void SetOwner()
    {
        Networking.SetOwner(Networking.LocalPlayer, this.gameObject);
    }
}

「Udon Sharpを使いたい」の8～10を参考に作成したUdonSharpをオブジェクトにアタッチする。
[SerializeField] public TextMeshProUGUI _~~;と書いている分、オブジェクトを割り当てる。
UdonSharpをアタッチしたオブジェクトのInspectorタブの#(Script)内のUtilities内に、書いた分行が出来ているので、どれにどのオブジェクトを割り当てるかをドラッグアンドドロップなどで指定する。
対象のボタンを選択し、"Inspector"ウィンドウの上の方にある"Button"の"On Click"のところで、"Runtime only","UdonBehaviour.SendCustomEvent(string)",(呼びたいメソッドをアタッチしたObject名),(呼びたいメソッド名)と設定する。
複数呼びたいときは"+"ボタンで欄を追加して、同様のことを実施する。

【参考】

ワールド内の一部分を撮って投影したい

"RenderTexture" アセットの作成
1. メニューバーの "Assets" > "Create" > "Render Texture" の順にクリック
2. 必要に応じてSizeで縦横比の設定などを行う。
カメラの設置
1. "Hierarchy"ウィンドウで右クリック > "Camera" とクリックする。
2. "Inspector"ウィンドウの"Camera"の真ん中よりちょっと下の"Target Texture"に、作成したRenderTextureを選ぶ。(◎をクリックして選択するなり、下方の"Assets"からD&Dする)
3. 映したいものに応じて、"Inspector"ウィンドウの"Camera"内3つ目の"Culling Mask"で"UI","PlayerLocal","UiMenu","InternalUI"などのチェックを外す
4. 必要に応じて写す位置や方向などを調整する。
  - 位置や方向の調整："Scene"上の矢印を使ったり、"Inspector"ウィンドウの"Transform"の値を変更
  - 画角："Inspector"ウィンドウの"Camera"の"Field of View"。大きいほど広角
  - 写す範囲："Inspector"ウィンドウの"Camera"の"Clipping Planes"。"Near"~"Far"の範囲が撮れる。
投影面の設置
1. "Hierarchy"ウィンドウ内で右クリック > "3D Object" > "Quad" とクリックする。
2. "Inspector"ウィンドウの"Transform"内の"scale"で投影したい映像の縦横比に合わせて置く
3. 作成された"Quad"に作成したRenderTextureをD&Dする。
4. "Inspector"ウィンドウで"～～(Material)"と書いてある下の"Shader"で、"Unlit" > "Texture"と選択。

【参考】

Udon Sharpで～したい

Udon Sharpを使いたい

オブジェクトを選択して、右側の「Inspector」内の「Add Component」ボタンをクリックします。
入力欄が出てくるので「udon」と打って出てきた、「Udon Behavior」をクリックする。「Inspector」内に「Udon Behavior (Script)」というのが追加される。
下の「Project」タブの「Assets」内で右クリックし、Create > U# Script とクリックします。
あらかじめ右クリック > Create > Folder で、Scriptをまとめて入れて置くフォルダを作成しておくとよい。
「Save UdonSharp File」ウィンドウが開くので、ファイル名欄にスクリプトの名前を入れて、「保存」ボタンを押します。
3.で右クリックした場所に、4.で付けたファイル名でファイルが二つ出来ている。
大きく"#"が書かれている方をダブルクリックして、プログラムのエディタを立ち上げる。

コードを書く。下記は基本的な例。

using UdonSharp;
using UnityEngine;
using VRC.SDKBase;
using VRC.Udon;
// ↑いろいろ使うためのおまじない。
// Udon#では文頭に//をつけるとコメント行になります。

public class UdonSharpCode : UdonSharpBehaviour
//「public class 名前 : UdonSharpBehaviour」で基底クラス? を宣言? これもおまじない。
// 名前は4.で付けたファイル名と同じにする
{

    private void Update()
    // この下の{　}内に毎フレームごとに呼び出したい処理を書く
    {
    
    }
}

Ctrl + S などをして保存してエディタを閉じる。
1.で選択していた、オブジェクトを再度選択する。
2.で追加された「Udon Behavior (Script)」の「Program Source」右隣にある「None（Abstract ～」と書かれている所の◎マークをクリックします
「Select AbstractUdonProgramS～」というウィンドウが出てくるので、入力欄に4.で付けたファイル名の一部を入れると、当該ファイルが出てくるのでクリックする。

Udon Sharpのコードの基本的な書き方を知りたい。

// を付けたあとはコメント扱いになる
命令の区切りに;を入れる必要がある
if文とかの範囲の区切りは { }

【参考】

コードの主な流れは下記。

using ～で使いたいものを取り込む

たぶんpythonのimportとかCのinclude的なやつ。

using UdonSharp;
using UnityEngine;
using VRC.SDKBase;
using VRC.Udon;

(Legacyの)UI使うときは、using UnityEngine.UI;も入れる。
TextMeshProを使うときは、using TMPro;も入れる。

クラスを宣言する

public class ClassName : UdonSharpBehaviour
{

ClassNameの場所は.csのファイル名と一致させる必要がある

変数を宣言する

    private bool isHoge = false;
    private float fuga;
    public GameObject piyo;
    [SerializeField] public TextMeshProUGUI _intLabel;
    
    [UdonSynced, FieldChangeCallback(nameof(IntData))] 
    private int _intData;

("属性") "アクセス修飾子" "変数の型" "変数名" (=初期値) という風に行う。
- 属性：
  後からjoinした人にも同様な値を見せたい変数には[UdonSynced]とつけたりする。
- アクセス修飾子：
  変数がアクセスできる範囲を定める。
  他のクラスからもアクセス可能にするならpublic、不可にするならprivateにする。
- 変数の型：
  その変数にどういうものが入るのかを書く。
  True/Falseならbool、整数ならint、小数含む数ならfloat、何かオブジェクトならGameObject、TextMeshProなUIならTextMeshProUGUIとする。

メソッドを宣言して、やりたいことを書く。

メソッド：Pythonでいう関数的なやつ。

    private void Update()
    {
    }

    private override void Interact()
    {
    }

メソッドの宣言は "アクセス修飾子" (override) void "関数名"() と行う。
クラス外から実行したい関数はアクセス修飾子をpublicにすること。
(e.g. UIのボタンを押したときに呼ばれたい関数)
メソッド名には特別なものがある。毎フレーム呼ばれるUpdate、インタラクト時に呼ばれるInteract、スクリプトをアタッチしたオブジェクトが、初めてActiveになった際に実行されるStartなど。

クラスを閉じる。

Udon Sharpでオブジェクトを操作したい

「Udon Sharpを使いたい」に従って、コードを作成し、オブジェクトにアタッチする。
「Udon Sharpを使いたい」の5.の手順と同様に大きく"#"が書かれている方をダブルクリックして、プログラムのエディタを立ち上げる。
コードを書き換える。一例としてキューブの回転の止める/回すをインタラクトで切り替えるプログラムを記す。

using UdonSharp;
using UnityEngine;
using VRC.SDKBase;
using VRC.Udon;

public class Spinning_Cube : UdonSharpBehaviour
{
    private bool isSpinning = false;
    // isSpinningはtrue or false な変数(bool)だよ。初期値はfalseだよ。

    private void Update()
    // この下の{　}内に毎フレームごとに行いたい処理を書く
    {
       if(isSpinning)
       // isSpinningがTrueのときは下の{ }の中身を実行
        {
            transform.Rotate(Vector3.up, 90f * Time.deltaTime);
            // transform. : 何かモノを動かすよ
            // Rotate(a,b): 回転させるよ。aで回転軸,bでどれくらいを指定するよ
            // Vector3.up : Step3の画像2枚目で示した緑色の矢印 (= 床面に垂直方向)
            // 90f * Time.deltaTime : 単位時間あたりに90度
        }
    }

    private override void Interact()
    // この下の{ }内にインタラクトされたときに行いたい処理を書く
    {
        isSpinning = !isSpinning;
        // isSppiningの値を反転させるよ
    }
}

Udon Sharpで同期したい。

下記のようなコードを書く。

using UdonSharp;
using UnityEngine;
using UnityEngine.UI;
using VRC.SDKBase;
using TMPro; // TextMeshProを使う場合はこれが必要

[UdonBehaviourSyncMode(BehaviourSyncMode.Manual)]
public class UI : UdonSharpBehaviour
{
    [SerializeField] public TextMeshProUGUI _boolLabel; // 同期した状態を表示するTextMeshProのオブジェクト
    [SerializeField] public TextMeshProUGUI _intLabel;  // 同期した値を表示するTextMeshProのオブジェクト

    [UdonSynced, FieldChangeCallback(nameof(BoolData))]
    private bool _boolData;
 // よくわからんがBool値を同期するときはこう書く。上行の"BoolData"がクラス名、下行の"_boolData"がローカルで使う変数名っぽい?
 
    [UdonSynced, FieldChangeCallback(nameof(IntData))] 
    private int _intData;
// 整数を同期するときはこう

    public bool BoolData
    {
        get => _boolData;
        set
        {
            _boolData = value;

            // 値のセットがあったときに入れたい処理を↓に書く
            _boolLabel.text = $"bool: {_boolData}"; // 今回はテキストの中身を書き換える
        }
    }

    public int IntData
    {
        get => _intData;
        set
        {
            _intData = value;

            // 実際の処理
            _intLabel.text = $"int: {_intData}";
        }
    }

    public void ToggleBool() // ボタンクリックなどではここを呼ぶ
    {
        // 同期変数変更するためのオーナー譲渡
        SetOwner();

        // 値変更
        BoolData = !BoolData;
        RequestSerialization(); // オーナーからみんなに値を配る
    }

    public void AddInt()
    {
        // 同期変数変更するためのオーナー譲渡
        SetOwner();

        // 加算処理
        IntData++;
        RequestSerialization();
    }

    public void DecInt()
    {
        // 同期変数変更するためのオーナー譲渡
        SetOwner();

        // 加算処理
        IntData--;
        RequestSerialization();
    }

    private void SetOwner()
    {
        Networking.SetOwner(Networking.LocalPlayer, this.gameObject); // 自分にオーナー権限を移す
    }
}

【参考】

You get articles that match your needs
You can efficiently read back useful information
You can use dark theme

What you can do with signing up

VRC Worldで～したいときの方法

worldを～したい

worldを作成したい

worldをアップロードしたい

オブジェクトを～したい

オブジェクトを置きたい

オブジェクトをグループ化して動かしたい

オブジェクトを反転させたい

オブジェクトを整列したい/均等に並べたい

オブジェクトをぴったりくっつけたい

オブジェクトを拾えるようにしたい

オブジェクトが落ちるようにしたい(重力を効かせたい)

オブジェクトの物理演算を無効/有効にしたい

オブジェクト同士がぶつかるようにしたい/すり抜けるようにしたい

オブジェクトとアバターがぶつかるようにしたい

オブジェクトに色を付けたい

オブジェクトに画像を表示したい

Planeの表裏で別の画像を表示したい

UIを～したい

UIを作成したい

UIのボタンで～したい

ワールド内の一部分を撮って投影したい

Udon Sharpで～したい

Udon Sharpを使いたい

Udon Sharpのコードの基本的な書き方を知りたい。

using ～ で使いたいものを取り込む

クラスを宣言する

変数を宣言する

メソッドを宣言して、やりたいことを書く。

クラスを閉じる。

Udon Sharpでオブジェクトを操作したい

Udon Sharpで同期したい。

using ～で使いたいものを取り込む