#topicpath
*2.1. プログラミングの準備 [#w5697754]
#contents
~本項目では、ロボットのプログラミングを始めるまでに必要な手順について説明します。
~
** ワークスペースの作成 [#x2b1eaf1]
~本ソフトウェアでは、ロボット毎に独立したプログラミング設定を作成することができます。この設定を「ワークスペース」と言います。ロボットのプログラムを作成する場合、最初にお使いのロボットに対するワークスペースを作成する必要があります。
~
~新しくワークスペースを作成する場合、メニューより「ファイル」→「ワークスペースの新規作成」をクリックしてください。クリックすると、「ワークスペースの新規作成」画面を開くので、ワークスペース名や作成先などを入力してください。デフォルトの設定で問題なければ、そのまま「作成」をクリックしてください（ワークスペースの作成先はデフォルトの設定では「マイドキュメント\VstoneMagic\WorkSpace\」のフォルダに作成されます）。
~
#ref(http://www.vstone.co.jp/sotamanual/sotamanual_pict/vstonemagic/image023.png,70%)
~
#ref(http://www.vstone.co.jp/sotamanual/sotamanual_pict/vstonemagic/image024.png,70%)
~
■テンプレート…使用するロボットの機種を選択
■名前…ワークスペースの名前を半角英数文字で入力
■作成先…ワークスペースを作成するフォルダを入力
~
~
~「作成」をクリックすると、「作成先」で指定した場所に、設定した名前のフォルダが作成され、また、作成したワークスペースを本ソフトウェアで開いた状態になります。
#ref(http://www.vstone.co.jp/sotamanual/sotamanual_pict/vstonemagic/image025.png,70%)
~
~
~
~
~また、ワークスペースのフォルダには、「(ワークスペース名).VWS」と言うファイルがあります。本ソフトウェアを起動していない状態で、このファイルをダブルクリックすると、最初からワークスペースを開いた状態でソフトウェアを起動します。
~
#ref(http://www.vstone.co.jp/sotamanual/sotamanual_pict/vstonemagic/image026.png,70%)
~
~
~
~
~
** パッケージとクラスの概要 [#m3972749]
~ロボットのプログラムファイルは、複数のメソッドをまとめた「クラス」と、更にクラスを複数まとめた「パッケージ」の二段階で必ず構成されます。プログラムを作成する場合、まずはこれらをワークスペースに作成します。なお、ワークスペースの作成時に選択したテンプレートによっては、既にパッケージとクラスが作成されている場合があります。
~
#ref(http://www.vstone.co.jp/sotamanual/sotamanual_pict/vstonemagic/image027.png,70%)
~
~
~
~
■パッケージとクラスの例(Sota)
ワークスペースのテンプレートにSotaを選択した場合、「jp.co.mysota」というパッケージと
「mymain.java」と言うクラスがあらかじめ作成されています。
~
~
~
~パッケージやクラスが存在しない場合や、今後これらを追加する必要がある場合、その作成手順を次ページより説明します。既にパッケージやワークスペースが存在する場合、次項「ロボットの通信設定と接続」から引き続きお読みください。
~
~
~パッケージを追加する場合、エクスプローラの「src」を右クリックしてポップアップメニューを表示してください。続いて、メニューの「新規」→「パッケージ」をクリックしてください。クリックすると、「パッケージの追加」画面を開くので、パッケージ名を入力してください。
~
#ref(http://www.vstone.co.jp/sotamanual/sotamanual_pict/vstonemagic/image028.png,70%)
~
#ref(http://www.vstone.co.jp/sotamanual/sotamanual_pict/vstonemagic/image029.png,70%)
~
【パッケージ名について】
一般的なjavaプログラミングでは、原則としてパッケージ名は他者と重複しないユニークな命名を行います。
例えば「yahoo.co.jp」など、個人や企業でドメインを取得している場合、そのドメイン名はユニークな名前であると言えます。
一般的なjavaのプログラムでは、このドメイン名を逆転したものをパッケージ名に使用します。
~
~
~
~
~名前を入力して「OK」をクリックすると、エクスプローラの「src」の項目に、作成したパッケージが追加されます。
~
#ref(http://www.vstone.co.jp/sotamanual/sotamanual_pict/vstonemagic/image030.png,70%)
~
~
~
~続いてクラスを作成します。追加したパッケージを右クリックしてメニューを開き、「新規」→「クラス」をクリックしてください。クリックすると、「クラスの追加」画面を開くので、各種項目を入力してください。
~
~
#ref(http://www.vstone.co.jp/sotamanual/sotamanual_pict/vstonemagic/image031.png,70%)
~
#ref(http://www.vstone.co.jp/sotamanual/sotamanual_pict/vstonemagic/image032.png,70%)
~
~
■追加先のパッケージ…クラスを追加するパッケージを選択
■クラス名…クラスの名前を半角英数文字で入力
■テンプレート…使用するロボットの機種を選択
~
~
~
~
#ref(http://www.vstone.co.jp/sotamanual/sotamanual_pict/vstonemagic/image033.png,70%)
項目を入力し「OK」をクリックすると、エクスプローラのパッケージ内に作成したクラスが追加されます。
~
~
~
~実際のプログラミングについては、次章で説明します。~
_
** ロボットの通信設定と接続 [#u20952bc]
~プログラムの作成中や実行時には、ロボットと通信する必要があります。次の手順で、本ソフトウェアより通信設定を行い、ロボットと通信させてみましょう。
~ロボットとの通信はネットワーク経由で行われます。ロボットと通信するためには、PCとロボットを同一ネットワーク上に接続して、本ソフトウェア上で、接続先のロボットのIPアドレスを指定する必要があります。ロボット本体のネットワーク接続方法、及びIPアドレスの確認方法は、以下をそれぞれご参照ください。
~
~[[≫各種ネットワークへの接続方法>ネットワークへの接続]]
~[[≫IPアドレスの確認（設定モード中の「IPアドレスの確認」）>設定モード]]
~
~
|COLOR(#FF0000){※ ロボット本体は、あらかじめ起動してネットワークに接続した状態にしてください。また、音声合成（発話）や音声認識機能はクラウドサーバへの接続を行うため、インターネットが利用できるネットワーク環境をご利用ください。}|
~
~
~
~本ソフトウェアの通信設定を行う場合は、メニューの「設定/通信」→「接続設定...」をクリックして、ロボットの通信設定画面を開いてください。
~
#ref(http://www.vstone.co.jp/sotamanual/sotamanual_pict/vstonemagic/image034.png,70%)
~
~
~
~
#ref(http://www.vstone.co.jp/sotamanual/sotamanual_pict/vstonemagic/image035_.png,70%)
設定画面には、現在登録されているロボットの接続設定がリストアップされています。ワークスペースの作成時に選択したテンプレートによっては、既に接続先が登録されている場合があります。下図は、ワークスペース作成時にテンプレートで「Sota」を選択した場合に、最初から登録されている接続設定です。
~
~
~
-ロボットの接続設定画面例（テンプレートに「Sota」を選択した場合）
~
#ref(http://www.vstone.co.jp/sotamanual/sotamanual_pict/vstonemagic/image036_.png,70%)
ここでは、例としてSotaの接続設定の手順を説明します。Sotaには、Raspberry Pi版とEdison版の2種類が存在するため、接続先としてあらかじめこれらの2種類が登録されています。お使いのSota本体の仕様に合わせて、どちらかをクリックしてください。どちらかの接続先をクリックしたら、設定画面下の「設定変更」をクリックしてください。
~
~
~
~
~ちなみに、これら以外にもう一つ登録されている設定（「プラットフォーム」が’Virtual’の物）は、仮想ロボット用の接続設定です。仮想ロボットは、ロボットの実機が無い状態で、PC上に表示されるロボットの3Dモデルを仮想ロボットとして操作する場合に使います。詳しくは[[「仮想ロボットによるシミュレーション」>../../仮想ロボットによるシミュレーション]]の項目をご参照ください
~
~ 「設定変更」をクリックすると、選択した項目の詳細設定画面を開きます。Sotaの場合、設定変更が必要な項目は「host」のみです。hostの項目をクリックし、ロボット本体のIPアドレスに書き換えてください。設定を書き換えたら「OK」をクリックしてください。
~
#ref(http://www.vstone.co.jp/sotamanual/sotamanual_pict/vstonemagic/image037.png,70%)
~
~
~
~「OK」をクリックすると、ロボットの通信設定画面に戻ります。戻ってきた画面上で、「接続先」の項目が正しく書き換わっているか確認し、続いて「接続」をクリックしてください。クリックすると、設定画面を閉じてロボットとの通信を開始します。
~
~
#ref(http://www.vstone.co.jp/sotamanual/sotamanual_pict/vstonemagic/image038_.png,70%)
~
~
~
~ロボットとの接続状態は、ツールバーの「通信ボタン」で表示されます。ロボットと正しく通信できた場合、通信ボタンのアイコンが「通信準備中」→「通信中」と変化します。アイコンが「通信エラー」になった場合、本ソフトウェアの設定、またはPC・ロボット本体・ネットワーク環境全体のいずれかの問題が考えられます。
~
#ref(http://www.vstone.co.jp/sotamanual/sotamanual_pict/vstonemagic/image039.png,70%)
~
~
***通信ステータス（通信ボタンのアイコンの状態） [#kb641ed3]
-http://www.vstone.co.jp/sotamanual/sotamanual_pict/vstonemagic/image040.png … 未接続
-http://www.vstone.co.jp/sotamanual/sotamanual_pict/vstonemagic/image041.png … 通信中
-http://www.vstone.co.jp/sotamanual/sotamanual_pict/vstonemagic/iconStartOnline3l.PNG … 通信準備中
-http://www.vstone.co.jp/sotamanual/sotamanual_pict/vstonemagic/image042.png … 通信エラー
-http://www.vstone.co.jp/sotamanual/sotamanual_pict/vstonemagic/image042_1.png … 接続先のプラットフォームが不明(Unknown)
~
正しく通信できない場合、以下の事項をそれぞれご確認ください。
~
-ロボットのIPアドレスが本ソフトウェアで設定したものと同じか
-PC及びロボット本体が同じネットワークに接続できているか
-ネットワーク環境に接続の制限を行うような設定が行われていないか
-ネットワーク環境のトラフィックや、その他動作に問題が無いか
-接続先のプラットフォームが不明の場合、一度通信を切断して接続しなおしてみる
~
これらに問題が無い場合、お使いのネットワーク環境のポート設定が影響している可能性が考えられます。[[こちらのQ&A>Q＆A#lf25a9c5]]を参考に、ファイヤーウォールの設定などで通信に必要なポートが解放されているかご確認ください。
~
~
~
~
~ロボットとの通信を切断したり、再度同じロボットに接続する場合は、通信ボタンをクリックしても行うことができます。
~未接続以外( http://www.vstone.co.jp/sotamanual/sotamanual_pict/vstonemagic/iconStartOnline3l.PNG / http://www.vstone.co.jp/sotamanual/sotamanual_pict/vstonemagic/image041.png / http://www.vstone.co.jp/sotamanual/sotamanual_pict/vstonemagic/image042.png /http://www.vstone.co.jp/sotamanual/sotamanual_pict/vstonemagic/image042_1.png )の状態でクリックすると通信を切断し、未接続( http://www.vstone.co.jp/sotamanual/sotamanual_pict/vstonemagic/image040.png )の状態でクリックすると、同じ接続先に通信を開始します。
~
~
~~
[[目次>MenuBar]] [[次のページへ>>>../単純なモーションプログラムの作成]]
