====== VCIスクリプトの開発環境の導入 ======
<WRAP center round important 80%>

このページは過去の情報となります。\\
新しいドキュメントは**[[https://developer.virtualcast.jp/vci-docs/manual/scripting/index.html|こちら]]**になります。
</WRAP>

VCIスクリプトの作成には、**VSCode**の使用を推奨しております。\\
VSCodeを使用することで、以下のことが可能です。
  * Lua言語によるスクリプトを作成
  * バーチャル空間でのリアルタイムコーディング（スクリプトを書き換え）
  * デバッグ




===== 必要なファイル =====
下記ファイルのダウンロードおよびインストールが必要になります。

  * [[https://code.visualstudio.com/|Visual Studio Code (VSCode)]]


==== VSCode ====

**[[https://code.visualstudio.com/|VSCode]]**とはMicrosoft社が提供するオープンソースのテキストエディタです。([[https://ja.wikipedia.org/wiki/Visual_Studio_Code|Wikipedia]])\\
VCIのスクリプトを作成する際に使用します。


===== VSCodeで入力補助を有効にする =====

==== Luaの入力補助を有効にする ====

{{:vscode:visual-studio-marketplace.png?direct&600|}}

[[https://marketplace.visualstudio.com/items?itemName=sumneko.lua|Visual Studio Marketplace]]を開いて「Install」を選択します。\\
「このサイトは、Visual Studio Codeを開こうとしています」と表示された場合は「開く」を選択します。

{{:vscode:lua-vscode.png?direct&600|}}

VSCodeが開いたら「Install」を選択します。\\
これでLuaの入力補助が有効になります。

==== VCIの入力補助を有効にする ====
<wrap lo>これまでVCIを利用したことが無い場合、**バーチャルキャストでVCIを読み込んで１度出現させてください。**\\
バーチャルキャストの実行時に作成されるフォルダーとファイルが必要な作業になります。</wrap>

<WRAP center round box 95%>

**1. VSCodeを立ち上げて[ファイル > フォルダーを開く] からフォルダーを開きます。**

<code>C:/Users/_USER_/AppData/LocalLow/VirtualCast/VirtualCast</code>

上記のパスにある[EmbeddedScriptWorkspace]フォルダーを開きます。\\
※''_USER_''の部分はパソコンに設定されたユーザーネームです。

{{vscode:luapath.png?direct|}}

</WRAP>



<WRAP center round tip 95%>
<WRAP group>
<WRAP half column>
**AppDataフォルダーが非表示になってる場合**

エクスプローラーオプション(フォルダー設定)から[表示 > 隠しファイル]にチェックを入れてください。


</WRAP>

<WRAP half column>
{{ vscode:vci_sample_folder.png?direct&250 }}
</WRAP>
</WRAP>

</WRAP>


<WRAP center round box 95%>

**2. VSCode側で[types.lua]と[template.lua]が読み込まれていれば、VCIの入力補助が有効になります。**

{{vscode:vci_vscodeinterisensu.png?direct&400|}}

</WRAP>


<WRAP center round tip 95%>
<WRAP group>
<WRAP half column>
**フォルダー展開時のダイアログ**

VSCodeは初期設定で制限モードになっているため、フォルダーを開いた際に次のようなダイアログが表示されます。\\
上記フォルダーに危険性はありませんので「信頼します」を選択してください。


</WRAP>

<WRAP half column>
{{ vscode:vci_security.png?direct&250 }}
</WRAP>
</WRAP>

</WRAP>

VCIスクリプトの開発環境の導入までを解説しました。

<wrap notice right>⇒ [[vscode/debugger]]</wrap>\\