発話を行うロボアプリの開発をしながら、開発手順について説明していきたいと思います。Androidプロジェクトを作成し、ロボアプリの初期設定を行い、ActivityがPepperを操作するために必要な実装について見ていきます。
1.プロジェクト作成
ロボアプリ開発にあたって、まず初めに標準的なAndroidプロジェクトを作成し、それにロボアプリの設定を追加します。Android StudioのFileメニューのNewからNew Projectを選択し、Androidプロジェクトを作成してください。プロジェクト作成時のTarget Android DeviceではPhone and TabletのAndroid 6.0 (Marshmallow)が選択してください。
2.ロボアプリの初期設定
作成したAndroidプロジェクトにロボアプリの初期設定を行います。
<手順>
1.FileメニューのNewからRobot Applicationを選択します。
2.サポートするRobot SDKのバージョンと追加するモジュールを選び、OKをクリックしてください。
3.Sync Project with Gradle Fileボタン(下図の参照)をクリックし、プロジェクトとGradleファイルを同期させます。
結果
これでロボアプリの初期設定が完了しました。以下のファイルが更新されていることが確認できます。
assetsにrobotディレクトリとrobotsdk.xmlファイルが追加されます。robotsdk.xmlファイルには、選択したRobot SDKのバージョンが含まれています。
appのbuild.gradle fileのdependenciesにQiSKDのモジュールが追加されます。これにより、アプリからQiSDKが利用できるようになります。
AndroidManifest.xmlにuses-featureタグが追加されます。追加されたuses-featureタグはアプリがPepperを使用することを示しています。
3.QiSDK実装とロボットのライフサイクル
ActivityからPepperを操作するために必要となる共通の実装について見ていきます。
<手順>
1.onCreateメソッドの中で、QiSDKにActivityを登録します。
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
QiSDK.register(this, this);
}
2.onDestroyメソッドの中でActivityの登録を解除します。
protected void onDestroy() {
QiSDK.unregister(this, this);
super.onDestroy();
}
※ QiSDK.unregister(this)を使用した場合は、ActivityのすべてのRobotLifecycleCallbacksの登録が解除されます。登録したままにしておくべきコールバックを解除してしまうことのないよう注意してください。
3.作成したActivityにRobotActivityを継承させます。これにより、Activityは会話の内容を画面に表示するSpeechBarを利用できるようになります。
public class MainActivity extends RobotActivity
4.追加したActivityにRobotLifecycleCallbacksを実装してください。
public class MainActivity extends RobotActivity implements RobotLifecycleCallbacks
このインターフェースはロボットフォーカスの獲得と喪失の通知を受けるためのものです。
5.onRobotFocusGained、onRobotFocusLost、onRobotFocusRefusedメソッドをオーバーライドで実装します。
@Override
public void onRobotFocusGained(QiContext qiContext) {}
@Override
public void onRobotFocusLost() {}
@Override
public void onRobotFocusRefused(String reason) {}
onRobotFocusGainedはActivityがロボットフォーカスを獲得した時に呼ばれます。ロボットフォーカスを獲得した時、ActivityはPepperに様々な動きをさせることが出来ます。 onRobotFocusLostはActivityがロボットフォーカスを失った時に呼ばれます。ロボットフォーカスを失った時、ActivityはPepperを動かすことが出来なくなります。
重要
onRobotFocusGainedとonRobotFocusLostメソッドはバックグラウンドスレッドで実行されるため、UIスレッドをブロックすることはありません。