まずはBaseChatbotReactionがどこの馬の骨かを知る🐎

BaseChatbotReactionとは、ChatbotReactionの親クラスです。前回のサンプルアプリに登場しましたね！
Chatbotが実行された場合のリアクションを実装するには、このBaseChatbotReactionを継承しなくてはならないのです。
✨$\huge{✨✨}$⭐️⭐️$\huge{✨}$⭐️⭐️$\huge{✨}$
$\tiny{ランプの阿修羅}$

啓請はしなくて大丈夫です。

BaseChatbotReactionを継承して、runWithメソッドとstopメソッドで何かをメイクする✊✌🖐

BasechatbotReactionを継承したカスタムリアクションクラスは、runwithメソッドとstopメソッドを実装しましょう。

Chatはユーザの音声を認識した時に各ChatbotのreplyToを呼び、認識した音声に対する応答があるかの確認を行います。Chatbotは、応答があった場合にStandardReplyReactionもしくはStandardAutonomousReactionを返します。

StandardReplyReactionもしくはStandardAutonomousReactionのコンストラクタの最初の引数には、BaseChatbotReactionを継承したリアクションオブジェクトを渡してください🕊🕊🕊🕊🕊🕊🕊🕊

return new StandardReplyReaction(
                new MyChatbotReaction(getQiContext(), "百年待っていて下さい"),
                ReplyPriority.NORMAL);

Chatは各Chatbotの応答内容から実行するリアクションを選択します。Chatが複数のリアクションを受け取った場合は、優先順位などから一つのリアクションを選択して実行します。
その実行時にリアクションオブジェクトのrunWithメソッドが呼ばれ、Pepperに動作させることができるのです。ちなみに、Pepperに礬水を塗ってはいけません✖️🖌
●●●●●$\huge{●●}$●●●●●●●$\huge{●●}$
$\tiny{イカ墨でボディーペイントされるPepper}$

stopメソッドはrunWithメソッド動作中に、runWithメソッドの内容を中断する必要がある場合に呼ばれます。具体的にはより優先順位の高いAutonomousReactionを実行する必要がある場合や、Chatがキャンセルされた場合などです。

これは特に何もお届けしない、光速未満の超高速で飛んでくるスカイフィッシュです。

コンストラクタを実に装う

BaseChatReactionを継承したクラスのコンストラクタはQiContextを受け取り、親クラスのコンストラクタを引き継がなくてはいけません。
第2引数で、発話内容など応答に必要な情報を渡すことが可能です。

public class MyChatbotReaction extends BaseChatbotReaction {

    private String answer;

    protected MyChatbotReaction(QiContext context, String answer) {
        super(context);
        this.answer = answer;
    }

}

BaseChatbotReactionが聞き取った台詞に応じて返答を選ぶ場合には、その聞き取った台詞を渡すような使い方が出来ます。~~ボトルメールの中身が遠い海岸の潮騒だった、というようなシチュエーションです~~
･｡..｡.･:.｡. .｡.:･゜ﾟ･･｡..｡.･:.｡. .｡.:･゜ﾟ･
･｡..｡.･:.｡. .｡.:･゜ﾟ･･｡..｡.･:.｡. .｡.:･゜ﾟ.･*👈$\tiny{ミルククラウンが添付されたボトル　(牛乳瓶)メール}$

runWith再び

runWithメソッドはSayアクション、AnimationアクションなどChat以外の様々なアクションが実行可能です。

❗️重要❗️
runWithでアクションを実行する際はonRobotFocusGainedなどで渡されたQiContextを使用せず、runWithの引数で渡されるSpeechEngineをQiContextとして使ってください。

runWithメソッド内で実行されるアクションはキャンセルできる必要があるので、非同期で実行しなければいけません🚨
キャンセル可能にするため、アクション実行時に生成されるFutureオブジェクトを保持しておきましょう。

❗️❗️重要❗️❗️
runWithメソッドは以下のように実装されます。

@Override
public void runWith(SpeechEngine speechEngine) {

    //Sayアクションをビルド
    Say say = SayBuilder.with(speechEngine)
                        .withText(answer)
                        .build();

    //アクションを非同期に実行し、Futureにリファレンスを保存
    fSay = say.async().run();

    //アクションが実行されるまでこのメソッドはそのまま
    try {
        fSay.get();
    } catch (ExecutionException e) {
        Log.e(TAG, "Error during Say", e);
    } catch (CancellationException e) {
        Log.i(TAG, "Interruption during Say");
    }
}

ここで、前回のサンプルアプリで説明していなかった部分を見てみましょう👁‍🗨以下のコードについてです。

fSay.get();

fAnima.get();

まず、アクションは非同期で実行しています。しかしそのままだとrunWithメソッドの処理は一瞬で終わり、Chatアクションが次の聞き取りを開始してしまうので意図した動作になりません。

しかしFutureのget関数を使えば、非同期で実行したアクションの終了をrunWithメソッド内で待つことができます。

同期処理でアクションを実行すればこの問題は解決できますが、同期処理の場合はキャンセルが出来ないのでこのようなイレギュラーなつくりとなる、というわけなのです💭

stop⛔️

ChatbotReactionに必須のメソッドで、runWithメソッド内で実行中のアクションをキャンセルします。森羅万象に取り返しがついてもらいたいですね。

サンプルのChatbotReactionでは、クラスのプロパティでアクションのFutureオブジェクトを保持し、stopメソッド内でそれを利用できるようにしています。

@Override
public void stop() {
    if (fSay != null) {
        fSay.cancel(true);
    }
}

さて、次の章からはStandardReplyReactionとStandardAutonomousReactionの二種類のリアクションをご紹介します。是非とも両者を攻略して二兎を得ましょう🐇🐇🛸

$\tiny{アブダクションされる雪兎たち}$

💡StandardReplyReactionのメイキング💫

StandardReplyReactionはReplyReactionの標準の実装です。これは前回も登場していましたね！
Chatが何かを聞き取った時のChatbotのリアクションを定義して、Chatbotに返答をお願いする役目があります。
先述の章で登場したものと同じですが、サンプルコードは以下のとおりです⬇️

return new StandardReplyReaction(
                new MyChatbotReaction(getQiContext(), "千年待っていて下さい"),
                ReplyPriority.NORMAL);

StandardReplyReactionは、BaseChatbotReactionを継承したクラスです。
BaseChatbotを継承した独自のChatbotクラスのreplyToが呼ばれた時、Chatbotの応答を返すために使われます。

BaseChatbotReactionは、先ほど説明したrunWithやstopメソッドを実装したクラスです。
ReplyPriorityで返答にNORMALかFALLBACKとして優先順位を設定します。FALLBACKの返答はNORMALの返答よりも優先順位が低いです。

💡StandardAutonomousReactionのメイキング💫

StandardAutonomousReactionはAutonomousReactionの標準の実装です。
こちらは今回が初めての登場で、記事のタイトルにあるようにちょっと自発的なPepperを作ってくれます。なんとReplyReactionとは対照的にユーザーからの入力を必要としないので、無人島でもひとり言を言わせたりエアギターをさせたりエア動物をしてもらったりすることが可能なのです。
$\tiny{エア象}$

 public void setAutonomous() {
//BaseChatbotReactionを継承するインスタンスを作成
  MyAutonomousChatbotReaction myAutonomousChatbotReaction = new MyAutonomousChatbotReaction(getQiContext());
//AutonomousReactionを作成
  StandardAutonomousReaction autonomousReaction = new StandardAutonomousReaction(
    myAutonomousChatbotReaction,
    AutonomousReactionImportance.LOW,
    AutonomousReactionValidity.DELAYABLE);

  oddChat.setAutonomousReaction(autonomousReaction);
        }

StandardAutonomousReactionもStandardReplyReaction同様、BaseChatbotReactionを継承したリアクションオブジェクトを引数として受け取ります。

StandardAutonomousReactionに渡すリアクションオブジェクトは、runWithメソッド内でSayやAnimationなどを実行します。
AutonomousReactionImportanceで、返答にHIGHかLOWかの優先順位を設定します。
AutonomousReactionValidityで、返答にIMMEDIATEかDELAYABLEかの時間的な優先順位を設定します。

AutonomousReactionValidityがDELAYABLEの場合はキューにデータを入れることができますが、IMMEDIATEの場合はすぐに実行されないと棄却される点に注意しましょう🔦

つまり、StandardReplyReactionのリアクション中にStandardAutonomousReactionのリアクションを実行しようとすると、DELAYABLEではStandardReplyReactionのリアクションの終了後にStandardAutonomousReactionのリアクションが実行されますが、IMMEDIATEではStandardReplyReactionのリアクションの終了後もStandardAutonomousReactionのリアクションは実行されません。

また、複数のStandardAutonomousReactionがありいずれもAutonomousReactionValidityがIMMEDIATEの場合、AutonomousReactionImportanceがLOWのリアクションはHIGHのリアクション中に実行しようとするとHIGHのリアクションが終了しても実行されませんが、HIGHのリアクションはLOWのリアクション中に実行しようとするとLOWのリアクション終了後に実行されます。

AutonomousReactionは、ChatbotのsetAutonomousメソッドで渡すことで実行可能です🟢

あとがき

今回もPepperSDKforAndroidを参考に書かせていただきました。
さらに詳しい情報はBaseChatbotReactionのAPIリファレンス、StandardReplyReactionのAPIリファレンス、StandardAutonomousReactionのAPIリファレンスなどを参照してみてください。

次回はText To Speechエンジンのタグについてです📛
鬼ごっこ(tag)は始まらないので逃げないでください。

それでは〜👹👏

Pepper SDK入門(29) BaseChatbotReactionでちょっと自発的なPepperに生まれ変わってもらう