Backup diff of Tutorial for ver.3 vs current(No. 21)

The added line is THIS COLOR.
The deleted line is THIS COLOR.
SIGVerse_v3はUnityを利用しており、Windowsで動作します。
ここでは、SIGVerse_v3(beta版)に必要な設定について説明します。
Up:[[SIGVerse]]
----
&color(red){&size(24){最新情報は以下のページを参照してください。};};  ~
&color(red){&size(24){https://github.com/SIGVerse/sigverse_unity_project/wiki};};

またROSを使用したサンプルは[[こちらのページ>Tutorial using ROS for ver.3]]にて説明します。
&size(18){ここでは、SIGVerse v3のチュートリアルついて説明します。};

&size(18){[[IROS2019 でのチュートリアルを実行したい方はこちらを参照して下さい。>http://www.sigverse.org/wiki/en/index.php?Tutorial%20at%20IROS2019]]};

#contents

* システム要件 [#j619746f]
* システム要件 [#SystemRequirements]

Unityを使用しますが、OSはWindows 10 64bitで動作確認を行っております。

その他のシステム要件は基本的に[[Unityのシステム要件>https://unity3d.com/unity/system-requirements]]に準拠してください。
また基本的に[[Unityのシステム要件>https://unity3d.com/unity/system-requirements]]に準拠してください。

''Unity Editor''
#ref(UnityEditor.png)




* 環境構築 [#bbc2e383]

** Unityのインストール [#t38ca130]

SIGVerseの開発環境となるUnityをインストールします。

+ [[ダウンロードページ>https://unity3d.com/jp/get-unity/download/archive]]から、Unity 2017.2.0→ダウンロード(Win)→Unityインストーラを選択し、インストーラをダウンロードします。
+ インストーラを実行し、手順に従ってインストールを進めます。
+ 次に、Unityを起動し、以下の手順でUnityアカウントを作成後、サインインします。
-- サインイン画面の「Create one」をクリック
-- アカウントを登録（ブラウザ上での登録）
-- 登録したアカウントを利用して「Sign In」
-- Licenseで「Personal」を選択（所属に応じて選択）
-- License agreementでは中央の「less than $100,000」を選択
-- Surveyでアンケートに答える
+ [[Unity Hubのダウンロードページ>https://unity3d.com/get-unity/download]]へ行きます。
+ [Download Unity Hub]をクリックして、Unity Hubのインストーラをダウンロードし、インストールします。
+ [[Unityのダウンロードページ>https://unity3d.com/get-unity/download/archive]]へ行きます。
+ [Unity 2021.x]→[Unity 2021.3.3f1]→[Unity Hub]をクリックして、Unity Hubを使用してUnityをインストールします。~
（モジュールの追加画面では特にモジュールの追加は必要ありません）
+ Unity Hub右上の人型アイコンをクリックし、[Sign in]をクリックします。
+ Unityアカウントを作成してから、サインインします。

以上の手順で、Unityを利用した開発が可能になります。

** SIGVerseのUnityプロジェクトのダウンロード [#j826be39]

** SIGVerse_v3のUnityプロジェクトのダウンロード [#j826be39]
+ [[こちら>https://github.com/SIGVerse/unity_project]]のページを開きます。
+ 「Code」→「Download ZIP」でzipをダウンロードして展開してください。 ~
但しファイルパスが長すぎると展開出来なかったり、Unityシーンが実行できないかもしれません。 ~
C:\Unityなどの短いディレクトリに展開してください。
+ フォルダ名を"sigverse_unity_project-master"から、"sigverse_unity_project"に変更します。

+ [[こちら>https://github.com/SIGVerse/unity_project]]からGitリポジトリをダウンロードします。
+ 「Clone or download」→「Download ZIP」でzipをダウンロードし、任意の場所に展開してください。~

Gitを利用されている方は、Windows環境の任意の場所にリポジトリをCloneしてください。


** Unityプロジェクトの開き方 [#ad0d2bef]

+ Unityを起動し、「OPEN」をクリックします。
+ フォルダの選択画面が表示されるので、前項でダウンロードしたプロジェクトを選択し（「unity_project」→「SIGVerseProject」）、
「フォルダーの選択」ボタンをクリックします。
+ Unity Hubの[Projects]-[ADD]をクリックします。
+ ダウンロード済みのUnityプロジェクト（[sigverse_unity_project]->[SIGVerseProject]）を選択し、[Select Folder]ボタンをクリックします。
+ プロジェクト一覧の[SIGVerseProject]をクリックします。



* ROSを使用しないサンプルシーンの実行 [#haea2311]


** Unityシーンの実行方法 [#open_scene]

* サンプルプログラムの実行 [#haea2311]
Unityのサンプルシーンは基本的に以下の手順で実行します。


** Unityシーンの開き方 [#open_scene]

Unityのサンプルシーンは基本的に以下の操作で実行します。

+ UnityでSIGVerse_v3プロジェクトを開きます。
+ [Project]タブの[Assets/SIGVerse/SampleScenes/xxxxx/yyyyy(.unity)]をダブルクリックしてシーンを開きます。
+ UnityでSIGVerseプロジェクトを開きます。
+ [Project]タブの[Assets/SIGVerse/ExampleScenes/xxxxx/yyyyy(.unity)]をダブルクリックして対象シーンを開きます。
+ Unity画面の上部中央にある再生ボタンをクリックしてシーンを再生します。
+ SIGVerseメニューの[Start]をクリックして、シーンを開始します。


** キャラクター視点で歩行するサンプルシーンの実行 [#k86f3d48]
** サンプル一覧 [#me019f75]

*** 起動手順 [#d76f4a67]
- [[一人称視点で歩行する]]
- [[キャラクター動作の記録・再生を行う（テキストファイルに保存）]]
- [[キャラクター動作の記録・再生を行う（MySQLに保存）]]
- [[Oculus Quest 2のハンドトラッキングでVRoidアバターの指を動かす]] （日本語のみ）

[[こちら>#open_scene]]を参考に[Assets/SIGVerse/SampleScenes/SampleHouse/SampleHouse(.unity)]シーンを開始します。


*** 実行 [#ddcefe40]
* ROSを使用したサンプルシーンの実行 [#r972fb26]

画面上で十字キー操作を行うとキャラクター視点でキャラクターが移動します。
ROSを使用したサンプルは[[こちらのページ>Tutorial using ROS for ver.3]]にて説明します。






** キャラクター動作の記録・再生を行うサンプルシーンの実行（テキストファイル使用） [#v627a606]

本シーンでは、キャラクター及び幾つかのオブジェクトの動きをテキストファイルへ記録・再生することができます。

*** 起動手順 [#c1ff4bda]

[[こちら>#open_scene]]を参考に[Assets/SIGVerse/SampleScenes/Playbacker/Playbacker(.unity)]シーンを開始します。

*** テキストファイルへの記録 [#oddbb270]

+ PlaybackerメニューのModeで[Text Recorder]を選択します。
+ [Output File]など、幾つかの設定を行います。
+ [Start]ボタンを押下すると、テキストファイルへの記録を開始します。
+ キャラクターを十字キーで操作します。
+ [Stop]ボタンを押下すると、テキストファイルへの記録を終了します。

*** テキストファイルからの再生 [#iad90eef]

+ PlaybackerメニューのModeで[Text Player]を選択します。
+ [Input File]で、上記の記録手順で設定したファイルパスを設定します。
+ [Start]ボタンを押下すると、再生を開始します。
+ [Stop]ボタンを押下するか、記録時間を経過すると、再生を終了します。





** キャラクター動作の記録・再生を行うサンプルシーンの実行（MySQL使用） [#rfc4309f]

本シーンでは、キャラクター及び幾つかのオブジェクトの動きをMySQLへ記録・再生することができます。

*** MySQL使用設定 [#be7e0a5b]

MySQLを使用する場合、最初に幾つかの手順が必要です。

まずSIGVerse設定画面でMySQLを使用するよう設定します。

+ Unityエディタの[SIGVerse]-[SIGVerse Settings]をクリックして、SIGVerse設定画面を開きます。
+ [Define symbols Settings]の[Use MySQL]にチェックを入れます。

Unityエディタでエラーが発生しますので、ライブラリを追加します。

+ MySql.Data.dll を[[ココ>https://dev.mysql.com/downloads/connector/net/6.7.html]] からダウンロードして、[Assets]タブの[Plugins]の下に配備します。~
（[Connector/Net]のバージョンは[6.7.9]、OSは[.NET & Mono]を選択し、zip解凍後の"v2.0"フォルダの中にあるdllで動作確認済みです）
+System.Data.dll をUnityインストールフォルダから取得して、[Assets]タブの[Plugins]の下に配備します。~
（C:\Program Files\Unity\Editor\Data\Mono\lib\mono\2.0の中にあるdllで動作確認済みです）

またMySQL Serverを構築します。詳細は省きますが、概要は次の通りです。

+ MySQL Serverをインストールします。（5.7.18で動作確認しました。MySQL Workbenchもインストールすると便利です。）
+ "sigverse"という名前のSchema（データベース）を作成します。 
+ "sigverse"に対して更新権限を持つMySQLユーザを作成します。
+ "sigverse"の下に"playbacker_motion_data"というテーブルを作成します。~
テーブル作成スクリプトは次の通りです。
 CREATE TABLE `playbacker_motion_data` (
   `recording_id` int(11) NOT NULL,
   `elapsed_time` int(11) NOT NULL,
   `data_type` int(11) NOT NULL,
   `motion_data` text NOT NULL,
   PRIMARY KEY (`elapsed_time`,`data_type`,`recording_id`)
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8;


*** 起動手順 [#t3463616]

[[こちら>#open_scene]]を参考に[Assets/SIGVerse/SampleScenes/Playbacker/Playbacker(.unity)]シーンを開始します。


*** MySQLへの記録 [#kb03705c]

+ PlaybackerメニューのModeで[Database Recorder]を選択します。
+ [Unique ID]やデータベース接続情報など、幾つかの設定を行います。
+ [Start]ボタンを押下すると、MySQLへの記録を開始します。
+ キャラクターを十字キーで操作します。
+ [Stop]ボタンを押下すると、MySQLへの記録を終了します。

*** MySQLからの再生 [#e12bcc33]

+ PlaybackerメニューのModeで[Database Player]を選択します。
+ 上記の記録手順で設定したデータベース接続設定や[Unique ID]と同じ設定を行います。
+ [Start]ボタンを押下すると、再生を開始します。
+ [Stop]ボタンを押下するか、記録時間を経過すると、再生を終了します。





----

#counter