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

The added line is THIS COLOR.
The deleted line is THIS COLOR.
SIGVerse_v3はUnityを利用しており、Windowsで動作します。
ここでは、SIGVerse_v3(beta版)に必要な設定について説明します。

またROSを使用したサンプルは[[こちらのページ>Tutorial using ROS for ver.3]]にて説明します。

#contents

* システム要件 [#j619746f]

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

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





* 環境構築 [#bbc2e383]

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

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

+ [[ダウンロードページ>https://unity3d.com/jp/get-unity/download/archive]]から、Unity 5.6.3（2017/08/18にセキュリティパッチ[[5.6.3p1>https://unity3d.com/jp/security?utm_campaign=other_japan_information_2017-08-18-Global-Editor-Security-Notification-JP-Final&utm_content=2017-08-17-Global-Editor-Security-Notification-JP&utm_medium=email&utm_source=Eloqua#issues]]が出ています）→ダウンロード(Win)→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を利用した開発が可能になります。


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

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

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


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

+ Unityを起動し、「OPEN」をクリックします。
+ フォルダの選択画面が表示されるので、前項でダウンロードしたプロジェクトを選択し（「unity_project」→「SIGVerseProject」）、
「フォルダーの選択」ボタンをクリックします。






* サンプルプログラムの実行 [#haea2311]


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

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

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


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

*** 起動手順 [#d76f4a67]

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


*** 実行 [#ddcefe40]

画面上で十字キー操作を行うとキャラクター視点でキャラクターが移動します。






** キャラクター動作の記録・再生を行うサンプルシーンの実行（テキストファイル使用） [#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\Unity5.6\Editor\Data\Mono\lib\mono\2.0の中にあるdllで動作確認済みです）
（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
Backup diff of Tutorial for ver.3 (No. 21)
