パッケージ com.jblend.media

メディアプレイヤーの基底となるクラスおよびインタフェースを提供しています。

参照:
          説明

インタフェースの概要
MediaImageOperator 画像を表示するメディアプレイヤーが実装するインタフェースです。
MediaPlayerListener メディアプレイヤーが発生する、メディアの再生開始、一時停止、再生終了などのイベントを待ち受けるリスナを実装するためのインタフェースです。
 

クラスの概要
MediaData すべてのメディアデータクラスが継承する基本クラスです。
MediaFactory メディアデータに固有のデータ保持クラス、およびプレイヤーを自動的に生成するためのクラスです。
MediaPlayer このクラスはすべてのメディアプレイヤーの基底となる抽象クラスです。
 

パッケージ com.jblend.media の説明

メディアプレイヤーの基底となるクラスおよびインタフェースを提供しています。


メディア種別とパッケージ

JSCLでは、個々のメディアごとにMediaDataクラスを継承したクラス、およびMediaPlayerを継承したクラスを格納したパッケージが用意されています。この関係を表1に示します。

表1. メディア種別ごとのパッケージ、提供クラス名
メディア パッケージ名 MediaData継承クラス MediaPlayer継承クラス
JPEG com.jblend.media.jpeg JpegData JpegPlayer
PNG com.jblend.media.png PngData PngPlayer
MNG com.jblend.media.mng MngData MngPlayer
SMAF com.jblend.media.smaf SmafData SmafPlayer
SMD com.jblend.media.smd SmdData SmdPlayer

メディアプレイヤークラス・インタフェース

以下にメディアプレイヤーを構成する主要なクラスおよびインタフェースの関連を示します。図中、「MIDlet実装クラス」はMIDletで実装するクラスを意味しています。

media_class_structure_jp.gif

図1. メディアプレイヤー主要クラス構成図

MediaData クラス
すべてのメディアデータクラスが継承する基本クラスを定義します。データの設定、および属性の取得のためのメソッドが定義されています。
SmdData、JpegData、PngData、MngData、SmafData クラス(メディアデータ保持クラス)

SMD、JPEG、PNG、MNG、SMAFそれぞれのデータを保持するためのクラスです。画像メディアを含むメディアはMediaDataインタフェース以外に画像の幅と高さを取得するためのメソッドが提供されます。また、SmafDataクラスではSMAFのコンテンツタイプ(CM、カラオケ、着信メロディ)を取得するためのメソッドも提供されます。

メディアプレイヤーに再生させるメディアデータはメディアの種類に応じてこれらのクラスに保持させます。

MediaPlayer クラス
メディアプレイヤーの基本機能を定義した抽象クラスです。すべてのメディアプレイヤーはこのクラスを継承しています。メディアデータの設定、再生、一時停止、再開、および停止などの機能を定義します。また、メディアプレイヤーが発生するイベントを待ち受けるためのイベントリスナの登録や削除の機能も定義されます。
MediaImageOperatorインタフェース
メディアの画像サイズの取得、メディア内の表示領域の位置の設定と取得、メディアプレイヤーの画面上での位置とサイズの設定と取得などの機能を定義します。画像メディアを表示するメディアプレイヤー(MediaPlayerのサブクラス)はこのインタフェースを実装しています。
SmdPlayer、JpegPlayer、PngPlayer、MngPlayer、SmafPlayer クラス
SMD、JPEG、PNG、MNG、SMAFそれぞれのメディアを再生するためのクラスです。メディアの種類によって提供するメソッドは異なります。SMD(着信メロディ)は画像を含まないため、SmdPlayerではMediaImageOperatorインタフェースは実装していません。また、SmafPlayerでは音高シフトの制御機能や、SMAFメディアのユーザイベントの通知のための機能が追加されています。
MediaPlayerListenerインタフェース
メディアプレイヤーからのイベントを受け取るためのインターフェースです。このインタフェースはMIDletが実装し、メディアプレイヤーに登録して使用します。メディアプレイヤーからのイベントは、1)メディアプレイヤーの状態変化、2)再生の繰り返しの2種類が通知されます。
SmafPlayerListenerインタフェース
SMAFメディアに定義されているユーザイベントをSmafプレイヤーから受け取るためのインターフェースです。このインタフェースはMIDletが実装し、SmafPlayerに登録して使用します。