Language:

サイドバー

バーチャルキャスト公式Wiki

メインメニュー

初心者向けガイド

VirtualCast

遊ぶ世界

THE SEED ONLINE

ニコニコ

SHOWROOM

配信

配信ツール

その他

wikiについて

デベロッパー向け


開発環境

VRM(アバター)

VCI(アイテム/背景)

VCI更新情報

更新日 - UniVCI バージョン
2021/03/17 v0.32
2.0.3b
2021/01/14 v0.31
2.0.1a
2020/12/03 v0.30
2.0.0b
2020/11/12 v0.30
2.0.0a
2020/10/22 v0.29
1.9.5b
2020/07/30 v0.29
1.9.3e
2020/06/25 v0.28
1.9.3c
2020/05/21 v0.27
1.9.2e

以前のアップデート履歴


GLB(背景)

vscode:debugger

VSCodeでデバッガを使用する方法

デバッガ(Debugger)とは、プログラムのデバッグを助けてくれるツールです。 デバッガには、変数の状態を確認したり、ステップ実行という方法でプログラムの動作が追う機能があります。

1.バーチャルキャストの設定

[VCIスクリプトのデバッガーのTPCポート番号]に適切な値を設定してください。推奨値は、41912です。

[スタジオにデバッグ情報を表示する]にチェックしてください。

2.VSCodeにデバッガのプラグインを追加

VSCodeを起動後、左のタブから拡張機能を選択して[MoonSharp]で検索してください。

[MoonSharp Debug]のページが新規のタブで開くので、そこからプラグインをインストールします。

3.VSCodeのワークスペースにlaunch.jsonを作成

VSCodeのデバッガをVirtualCastで使用する場合

[EmbeddedScriptWorkspace] フォルダの直下に [.vscode] のフォルダを作成し、その中に [launch.json] を作成する必要があります。( [launch.json] がデバッガの設定ファイルになります)

1. [EmbeddedScriptWorkspace] のフォルダを開く

エクスプローラーで以下で以下のフォルダを開いてください。

C:/Users/_USER_/AppData/LocalLow/infiniteloop Co,Ltd/VirtualCast/EmbeddedScriptWorkspace]

_USER_は使ってるパソコンのユーザー名になります。

既にVSCodeで [EmbeddedScriptWorkspace] フォルダを開いてる場合は、VSCodeのワークスペース上で右クリックからメニューを開いて[エクスプローラーで表示します]を押すと、開くことができます。

2.[EmbeddedScriptWorkspace] に [.vscode] という名前のフォルダを作成する

[EmbeddedScriptWorkspace] フォルダの直下に [.vscode] というフォルダを作成してください。

3.[.vscode]フォルダの中に[launch.json]を新規作成

[.vscode]フォルダの中でメニューを開き、[新規作成 > テキストドキュメント] を作成し、できたファイルを launch.json にリネームしてください。
※もしくは、下記の[launch.json]ファイルをダウンロードして[.vscode]内に保存してもよいです。

4.[launch.json]の中に下記をコピー&ペースト

launch.json

launch.json
{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "MoonSharp Attach",
            "type": "moonsharp-debug",
            "request": "attach",
            "debugServer": 41912,
            "HELP": "Please set 'debugServer':41912 (or whatever port you ar connecting to) right after the 'version' field in this json."
        }
    ]
}

先ほど作った[launch.json]ファイルを開いて、上記のテキストをコピー&ペーストして保存します。

※補足ですが…公式のリファレンスは “debugServer”: 41912, の記述箇所が間違ってます。
上記の[launch.json]は修正した内容になっています。
MoonSharp Debug

4.デバッガを使用する手順

バーチャルキャストにスクリプトを含むVCIを取り込みます。THE SEED ONLINEにVCIスクリプトを含むVCIをアップロードして、バーチャルキャストを立ち上げてSEED連携を行ってください。

詳しくはこちらのページをご覧ください。 バーチャルキャストで実行

スクリプトのデバッグを行う場合は、エクスポート時にVCIObject の[Script Enable Debugging]にチェックを有効にしてください。

デバッガの使い方

まず、VirtualCastを立ち上げてスタジオに入り、デバックを行うVCIを表示します。
その後、VSCodeの[デバッグ > デバッグ開始]からデバッガを起動します。

行番号の左をクリックすると、ブレークポイントの設定ができます。
ブレークポイントとは、ブレークポイントの行までプログラムが実行された場合一時停止する箇所 です。

上記の例では onGrab() の中にブレークポイントが設定されているので、スタジオに戻りVCIを掴みます。
掴んだ後、本来なら3回の print() が実行されるはずですが、実行されてないと思います。
VSCodeのデバッガツールから、ステップ実行させる事でプログラムが処理されます。
終了させる時は、左の赤いコンセントのアイコンでデバッガの実行を終了します。

デバッグコンソールや、左のバーを見る事で変数の状態を確認したりできるので print関数では追いづらい細かい挙動もチェックできます。

vscode/debugger.txt · 最終更新: 2021/06/22 19:47 by t-daihisa

ページ用ツール