com.docomostar.system
クラス PhoneTheme

Object
  上位を拡張 com.docomostar.system.PhoneTheme

public final class PhoneTheme
extends Object

携帯電話のテーマ設定機能を提供するクラスです。

音声発着信時等に表示される画面、及びテレビ電話通話中の代替画像に表示される画面を設定できます。 また、メニューのアイコンを一括で設定できます。

このクラス中で使用されている「静止画」「動画」「アバターデータ」とは具体的には以下のデータを指します。

導入されたバージョン:
Star-1.0

フィールドの概要
static int THEME_AV_CALL_IN
          テレビ電話着信を表すテーマ設定タイプです(=5)。
static int THEME_AV_CALLING [iアプリオプションAPI]
          テレビ電話通話中の代替画像を表すテーマ設定タイプです(=7)。
static int THEME_CALL_IN
          音声着信を表すテーマ設定タイプです(=2)。
static int THEME_CALL_OUT
          音声発信を表すテーマ設定タイプです(=1)。
static int THEME_CHAT_RECEIVED [iアプリオプションAPI]
          チャットメール着信を表すテーマ設定タイプです(=6)。
static int THEME_MESSAGE_RECEIVE
          メールおよび SMS 、メッセージ(R、F)着信を表すテーマ設定タイプです(=4)。
static int THEME_MESSAGE_SEND
          メールおよび SMS 発信を表すテーマ設定タイプです(=3)。
static int THEME_STANDBY
          待ち受け画面を表すテーマ設定タイプです(=0)。
 
メソッドの概要
static void setImageTheme(int target, int id)
           音声発着信時等に表示される静止画や Video トラックのみの動画、アバターデータを設定します。
static void setMenuIcons(int[] path, int[] ids) [iアプリオプションAPI]
           あるメニュー階層下のサブメニューのアイコンを一括設定します。
static void setMovieTheme(int target, int id) [iアプリオプションAPI]
           音声着信時等に再生される動画を設定します。
static void setSoundTheme(int target, int id)
           音声着信時等に再生されるサウンドやAudio トラックのみの動画を設定します。
 
クラス Object から継承されたメソッド
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

フィールドの詳細

THEME_STANDBY

public static final int THEME_STANDBY
待ち受け画面を表すテーマ設定タイプです(=0)。
setImageTheme メソッド、 setMovieTheme メソッドの target 引数として使用されます。

関連項目:
定数フィールド値

THEME_CALL_OUT

public static final int THEME_CALL_OUT
音声発信を表すテーマ設定タイプです(=1)。
setImageTheme メソッドのtarget引数として使用されます。

関連項目:
定数フィールド値

THEME_CALL_IN

public static final int THEME_CALL_IN
音声着信を表すテーマ設定タイプです(=2)。
setImageTheme メソッド、 setSoundTheme メソッド、 setMovieTheme メソッドのtarget引数として使用されます。

関連項目:
定数フィールド値

THEME_MESSAGE_SEND

public static final int THEME_MESSAGE_SEND
メールおよび SMS 発信を表すテーマ設定タイプです(=3)。
setImageTheme メソッドのtarget引数として使用されます。

関連項目:
定数フィールド値

THEME_MESSAGE_RECEIVE

public static final int THEME_MESSAGE_RECEIVE
メールおよび SMS 、メッセージ(R、F)着信を表すテーマ設定タイプです(=4)。
setImageTheme メソッド、 setSoundTheme メソッド、 setMovieTheme メソッドのtarget引数として使用されます。

関連項目:
定数フィールド値

THEME_AV_CALL_IN

public static final int THEME_AV_CALL_IN
テレビ電話着信を表すテーマ設定タイプです(=5)。
setSoundTheme メソッド、 setImageTheme メソッド、 setMovieTheme メソッドのtarget引数として使用されます。

関連項目:
定数フィールド値

THEME_CHAT_RECEIVED

public static final int THEME_CHAT_RECEIVED [iアプリオプションAPI]
チャットメール着信を表すテーマ設定タイプです(=6)。
setSoundTheme メソッドの target 引数として使用されます。

関連項目:
定数フィールド値

THEME_AV_CALLING

public static final int THEME_AV_CALLING [iアプリオプションAPI]
テレビ電話通話中の代替画像を表すテーマ設定タイプです(=7)。
setImageTheme メソッドの target 引数として使用されます。

関連項目:
定数フィールド値
メソッドの詳細

setImageTheme

public static void setImageTheme(int target,
                                 int id)
                          throws StoreException

音声発着信時等に表示される静止画や Video トラックのみの動画、アバターデータを設定します。 再配布不可識別子が設定されている静止画や動画やアバターデータについても、 このメソッドでテーマ設定が可能です。
アプリケーションが終了後もこの設定は有効です。 また、アプリケーション削除後もこの設定は有効です。

設定する静止画のエントリ ID は、 ImageStore.addEntry(MediaImage)メソッド、 ImageStore.getId()メソッド、 ImageStore.selectEntryId()メソッド により取得できます。

このメソッドでは、 Video トラックと Audio トラックの両方が含まれた動画は設定できません。 そのような動画を設定するには setMovieTheme(int, int) を利用して下さい。
設定する動画のエントリ ID は MovieStore.addEntry(MediaMovie) メソッド、MovieStore.getId() メソッドにより取得できます。 動画に Video トラックが含まれているかどうか、 Audio トラックが含まれていないかどうかは、 MediaResource.getProperty(String) の引数に、それぞれ MediaMovie.MP4_VIDEOTRACKMediaMovie.MP4_AUDIOTRACK を指定することによって調べることができます。

既に音声着信音やテレビ電話着信音に動画(動画の Audio トラック)が設定されている状態でこのメソッドを呼び出すと、 音声着信音やテレビ電話着信音がリセットされる場合があります。 リセットされるケースの詳細は以下の通りです。

音声着信音がリセットされる場合:
  • 既に、音声着信音・音声着信画面に、Audio・Video の両方のトラックが含まれている動画が設定されている状態で、 音声着信画面として、 Video トラックのみの動画や静止画を設定しようとした場合
  • 既に、音声着信音に、Audio トラックのみの動画が設定されている状態で、 音声着信画面として、Video トラックのみの動画を設定しようとした場合
テレビ電話着信音がリセットされる場合:
  • 既に、テレビ電話着信音・テレビ電話着信画面に、Audio・Video の両方のトラックが含まれている動画が設定されている状態で、 テレビ電話着信画面として、 Video トラックのみの動画や静止画を設定しようとした場合
  • 既に、テレビ電話着信音に、 Audio トラックのみの動画が設定されている状態で、 テレビ電話着信画面として Video トラックのみの動画を設定しようとした場合

なお、これらのケースにおいて、 リセットされることに対するユーザ確認は行われません。

設定するアバターデータのエントリ ID は AvatarStore.addEntry(AvatarData) メソッド、 AvatarStore.selectEntryId()メソッドにより取得できます。

引数 target には、 以下のいずれかのテーマ設定タイプを指定することができます。

引数 id に ImageStore のエントリ ID を指定する場合
引数 id に MovieStore のエントリ ID を指定する場合
引数 id に