UI_MoviePlayer ¶

   <task pointer> = UI_MoviePlayer( <parent pointer>, <background mode>, <x>, <y>, <width>, <height>, "<movie asset>", "<callback>")

   function <callback>(<task pointer>)

   end

引数 ¶

• <parent pointer> 親UIのポインタ
• <background mode> trueでバックグラウンドモード(GLレイヤの後ろで動画を再生する)。falseでフォアグラウンドモード(GL画面の手前に再生Viewを作成)
• <x>, <y> 表示座標。バックグラウンドモードでは無視される。
• <width>, <height> 表示サイズ。バックグラウンドモードでは無視される。
• <movie asset> 再生する動画asset。H.264推奨。
• <callback> 再生終了時に呼び出されるコールバック関数名。

戻り値 ¶

• <task pointer> 生成された UI_MoviePlayer タスクのポインタ

解説 ¶

OSのUI機能を使い、動画を再生する。

動画の再生領域となる View はOSのコントロールとして生成される。

必ずGL描画より手前(フォアグラウンドモード)または最奥(バックグラウンドモード)となり、GLによる描画中に混在させることはできない。

フォアグラウンドモード ¶

GL画面の手前に動画再生領域を生成し、そこで動画を再生する。 この再生領域は、UI_MoviePlayerタスクと同じタイミングで破棄される。

バックグラウンドモード ¶

GL画面の奥にあるView上で動画再生を行う。このため、GLによる描画が行われない領域については再生中の動画が表示されることになる。

ただし、デフォルトの状態ではGLのクリア色が不透明であるため、GLによる描画を行わない部分についても動画が表示されない。 GL_ClearColor() 関数を用いGLのクリア色としてアルファ値が透過になるような背景色を設定する必要がある。

   function setup()
       GL_ClearColor(0.0, 0.0, 0.0, 0.0)
   end

コマンド ¶

UI_MOVIE_SETPATH

再生する動画assetを再設定する

• UI_MOVIE_SETPATH

     pMovie = UI_MoviePlayer(...)
     sysCommand(pText, UI_MOVIE_SETPATH, "<new asset path>")
  

UI_MOVIE_GETPATH

現在設定されている動画assetのパスを取得する。

• UI_MOVIE_GETPATH

     pMovie = UI_MoviePlayer(...)
     <now asset path> = sysCommand(pText, UI_MOVIE_GETPATH)
  

UI_MOVIE_PLAY

現在設定されている動画assetの再生を開始する。

• UI_MOVIE_PLAY

     pMovie = UI_MoviePlayer(...)
     sysCommand(pText, UI_MOVIE_PLAY)
  

UI_MOVIE_STOP

現在再生中の動画を停止する。

• UI_MOVIE_STOP

     pMovie = UI_MoviePlayer(...)
     sysCommand(pText, UI_MOVIE_STOP)
  

UI_MOVIE_PAUSE

現在再生中の動画を一時停止する。

• UI_MOVIE_PAUSE

     pMovie = UI_MoviePlayer(...)
     sysCommand(pText, UI_MOVIE_PAUSE)
  

UI_MOVIE_RESUME

現在一時停止中の動画再生を再開する。

• UI_MOVIE_RESUME

     pMovie = UI_MoviePlayer(...)
     sysCommand(pText, UI_MOVIE_RESUME)