Choregraphe 2.5.5でPepperプログラミング（以下Pepper本）を試そうとすると、いくつかChoregrapheの動作が書籍と異なる点が出てきて戸惑う部分が多いかもしれません。

Pepper本では、胸のディスプレイで画像や動画を表示する際に、ある「おまじない」¹が必要であると書かれていました²。
しかし、2.5.5では「おまじない」は必要なくなりました³。
この記事では、本当に「おまじない」は必要ないのか検証したあと、なぜ必要なくなったかを見ていきます。

「おまじない」とは

Pepper本3.3.2「タブレットに画像を表示する」のステップ6では、以下のように書かれています。

最後に、おまじないが必要です。Show Imageボックスを動作させるためには、ビヘイビアの位置を変更しなければなりません。ビヘイビアは、プロジェクトの新規作成後はbehavior_1/behavior.xarというファイルとして保存されています。このbehavior.xarを、behavior_1フォルダの外、プロジェクトファイルの最上位階層（ルート）のファイルとなるように、ドラッグ＆ドロップで移動します。図3.3.4のようになっていればOKです。
― "Pepperプログラミング 基本動作からアプリの企画・演出まで" P66 より

図3.3.4は下図のような図でした。

「おまじない」とは、behavior.xarをルートディレクトリに移動することだったわけです。

2.5.5で「おまじない」をせずにディスプレイに画像を表示してみる

2.5.5でも「おまじない」は必要なのでしょうか。
試しに、Pepper本を参考に、2.5.5でディスプレイに1枚の画像を表示するだけのプログラムを作って動かしてみます。

1. まず、Multimedia→Tablet→Show Imageボックスをビヘイビアに配置し、下図のように接続します。
   

2. ルート直下に html ディレクトリを作成し、その下に適当な画像ファイル image.png を配置します。
   

3. 配置したShow Imageボックスの設定ダイアログを開き、ImageUrl変数に image.png を指定します。
   

4. アップロードして再生ボタンをクリックし、実行します。

5. Pepperのディスプレイに指定した画像が表示されたら成功です。
   

正常に動作しました。
ちなみに、「おまじない」をしてもうまく動きます。

なぜ「おまじない」が必要なくなったのか

なぜ2.5.5では「おまじない」が必要ないのでしょうか。
その答えは少しあとにして、まずは「おまじない」の背景を詳しく見ていきましょう。

旧バージョンで「おまじない」が必要だった理由

「おまじない」の背景を理解するためには、Pepper本の想定環境であるChoregraphe2.3のShow Imageボックス、Play Videoボックス、Show AppボックスのPythonスクリプトをみていく必要があります。

これらのボックスでは、_getAbsoluteUrlメソッドおよび_getAppNameメソッドとして、それぞれ以下のようなコードが定義されていました。

def _getAppName(self):
    import os
    if self.frameManager:
        behaviorPath = os.path.normpath(self.frameManager.getBehaviorPath(self.behaviorId))
        appsFolderFragment = os.path.join("PackageManager", "apps")
        if not (appsFolderFragment in behaviorPath):
            self.logger.error("appsFolderFragment is not in behaviorPath")
        fragment = behaviorPath.split(appsFolderFragment, 1)[1]
        return fragment.lstrip("\\/")
    else:
        self.logger.warning("No ALFrameManager")

def _getAbsoluteUrl(self, partial_url):
    import os
    subPath = os.path.join(self._getAppName(), os.path.normpath(partial_url).lstrip("\\/"))
    # We create TabletService here in order to avoid
    # problems with connections and disconnections of the tablet during the life of the application
    return "http://%s/apps/%s" %(self._getTabletService().robotIp(), subPath.replace(os.path.sep, "/"))

_getAbsoluteUrlメソッドは、ディスプレイに対して、「このURLからページをダウンロードして表示して」と指示するためのURLを作成するメソッドです。

少しややこしい話ですが、 PepperタブレットにおけるJavaScript活用コンテンツ(QiMessaging JavaScript)#タブレットでの画像や動画の表示で示されているように、Pepperとディスプレイはそれぞれ独立したシステムとして動いていて、ディスプレイからはPepperはあたかもWebサーバーであるかのように見えています。
そこで指示すべきURLのベースは、 http://robotのIPアドレス/apps/アプリケーション名/ という形になるようで、このアプリケーション名の部分を_getAppNameメソッドで得ています。

この_getAppNameメソッド内では、self.frameManager.getBehaviorPath(self.behaviorId) を実行することで、ビヘイビアの(ファイルシステム内の)パスを取得して、そのパスを分解して(パス中に定義されているはずの)アプリケーション名を得ています。
実は、このロジックが、 behavior.xarがプロジェクト中のルートディレクトリに存在することを前提に書かれてしまっていたので、「おまじない」をするよう記載していたわけです。

2.5.5 で「おまじない」が必要ない理由

では、2.5のボックスではどのようにこのコードが変化したのか、見てみましょう。
_getAppNameメソッドはなくなり、_getAbsoluteUrlメソッドのみになっています。

def _getAbsoluteUrl(self, partial_url):
    import os
    subPath = os.path.join(self.packageUid(), os.path.normpath(partial_url).lstrip("\\/"))
    # We create TabletService here in order to avoid
    # problems with connections and disconnections of the tablet during the life of the application
    return "http://%s/apps/%s" %(self._getTabletService().robotIp(), subPath.replace(os.path.sep, "/"))

2.3と見比べてみると非常にシンプルになっていることがわかります。
self.packageUid()は、そのボックスが所属するアプリケーションの識別名を返すメソッドで、Pythonボックスに標準で用意されているものです。

つまり、今までは、ビヘイビアのパスしか取得できなかったために、ボックス内でアプリケーションの名前を切り出す処理を自前で実装する必要があったのが、2.5からはボックスの機能としてアプリケーションの名前を得られるようなり、その機能はビヘイビアの位置に依存せず正しい名前を返すようになったため、「おまじない」が必要なくなったということのようです。

まとめ

今回見てきたディスプレイ系ボックスのように、Choregrapheのボックスライブラリの中身もバージョンにより更新されており、バグが解消している場合もあります。
ただし、今回の例のように、Choregrapheが(NAOqiが)標準で用意するようになったメソッドを使用するように変更されているケースもあるため、NAOqi 2.3以前で動かす想定のアプリをChoregraphe 2.5で作る、などとしてしまうと、ボックスが前提とする機能のサポートが正常に行われず、想定外のエラーに遭遇してしまう、ということも考えられます。

Choregrapheの各ボックスの詳細な変更履歴はリリースノートでは提供されていないため(新しいSayボックスと発話のカスタマイズのような大きな変更は別ですが)、常に追うのは難しい部分もありますが、たまに変更点を追いかけておくと思いもがけないところではまることを防げるかもしれません。