外部アプリケーションからメディアプレイヤーを起動する方法について説明します。

暗黙的インテント

ファイル指定連携IF

ファイルマネージャなどからダウンロード・保存済みのコンテンツを再生する方法です。

項目 内容
Intent形式 Activity
Action Intent.action.VIEW
Category Intent.category. DEFAULT
MIME Type "audio/*"
"video/*"
"application/ogg"
"application/x-ogg"
Data PATH String コンテンツ格納パス 必須

ブラウザ用連携IF

Webブラウザなどからストリーミング再生をする方法です。

項目 内容
Intent形式 Activity
Action Intent.action.VIEW
Category Intent.category. BROWSABLE
MIME Type "audio/*"
"video/*"
"application/ogg"
"application/x-ogg"
Data URL String コンテンツ格納URL 必須

明示的インテント

パッケージ指定連携IF

外部アプリケーションからメディアプレイヤーを起動する方法です。

項目 内容
Intent形式 Activity
Package com.nttdocomo.android.mediaplayer
Activity なし
Action Intent.ACTION_MAIN

ローカルファイル用連携IF

外部アプリケーションからダウンロード・保存済みのコンテンツを再生する方法です。

注意レジューム再生機能に関する詳細は、「レジューム再生機能」を参照してください。

項目 内容 非レジューム再生 レジューム再生
Intent形式 Activity
Package com.nttdocomo.android.mediaplayer
Action com.nttdocomo.android.mediaplayer.PLAY_VIEW
Extra LAUNCH_TYPE String 起動形式“PLAY” 必須 必須
Extra PATH String コンテンツ格納パス注意1 必須 必須
Extra START_STATUS String 再生位置指定
“RESUME”：前回中断した位置から再生開始
“TOP”：先頭から再生開始
（デフォルト："TOP"）		 （未使用） 任意
Extra CONTENT_TYPE String content-type（MIMEタイプ）を示す文字列を指定 任意 任意注意2
  • 注意1 ルートディレクトリからの完全パスを指定してください。
    例）/mnt/sdcard/music/sample.mp3
  • 注意2 CONTENT_TYPEが指定されなかった場合、もしくは無効だった場合は、実体が音楽コンテンツであっても動画プレイヤーで再生されます。

ストリーミング再生用連携IF

外部アプリケーションからストリーミング再生をする方法です。

  • 注意レジューム再生機能に関する詳細は、「レジューム再生機能」を参照してください。
  • 注意レジューム再生機能では、動画コンテンツに限り複数のURLを指定することができます。これを利用することによりストリーム再生時に画質などの切り替えが可能となります。この機能に関する詳細は、「動画ストリーミング再生時のマルチURL機能」を参照してください。
項目 内容 非レジューム再生 レジューム再生
Intent形式 Activity
Package com.nttdocomo.android.mediaplayer
Action com.nttdocomo.android.mediaplayer.PLAY_VIEW
Extra LAUNCH_TYPE String 起動形式“PLAY_STM” 必須 必須
Extra CONTENT_ID String コンテンツのID 不要 必須注意3
Extra URL String コンテンツ格納URL 必須 （未使用）
Extra URL1 String コンテンツ格納URL1 （未使用） 必須注意4
Extra URL2 String コンテンツ格納URL2 （未使用） 任意注意4
Extra URL3 String コンテンツ格納URL3 （未使用） 任意注意4
Extra LABEL1 String ボタン上段文字列1
（デフォルト："HI"）		 （未使用） 任意注意5
Extra LABEL2 String ボタン上段文字列2
（デフォルト："MID"）		 （未使用） 任意注意5
Extra LABEL3 String ボタン上段文字列3
（デフォルト："LOW"）		 （未使用） 任意注意5
Extra DESC1 String ボタン下段文字列1
（デフォルト：空白）		 （未使用） 任意注意5
Extra DESC2 String ボタン下段文字列2
（デフォルト：空白）		 （未使用） 任意注意5
Extra DESC3 String ボタン下段文字列3
（デフォルト：空白）		 （未使用） 任意注意5
Extra DEFAULT_PLAY String 再生するURL（1〜3） （未使用） 任意注意6
Extra START_STATUS String 再生位置指定
“RESUME”：前回中断した位置から再生開始
“TOP”：先頭から再生開始
（デフォルト："TOP"）		 （未使用） 任意
Extra CONTENT_TYPE String content-type（MIMEタイプ）を示す文字列を指定 任意 任意注意7
  • 注意3 CONTENT_IDは、メディアプレイヤーがレジューム情報を管理するために使用します。そのため、すべてのコンテンツ提供者が提供するコンテンツにおいて一意となるようにコンテンツ提供者のドメインを含める等、他の配信者とIDが重複しないように考慮してください。半角英数字1文字以上1024文字未満（URL表記に利用できるものに限る）としてください。
    CONTENT_IDが指定されていない場合は、URLで指定されたコンテンツを先頭から再生します。（レジューム情報は保存されません。）
  • 注意4 レジューム再生の場合、URLは1つ以上、最大3つまでを指定する必要があります。
    （音楽コンテンツではURL1以外は使用されません。）
  • 注意5 URL1/2/3 に対応するボタンフェース文字列を指定してください。
    （音楽コンテンツでは使用されません。）
    LABEL1/2/3, DESC1/2/3は半角12文字を超える場合は省略表示（「…」）されます。
    切り替えダイアログ上は、左から順にLABEL1, LABEL2, LABEL3 が表示されます。（下記参照）
    • 【表示例1】
      URL1：http://×××, LABEL1:高, DESC1:(300kbps)
      URL2：（設定なし）
      URL3：（設定なし）
      → 切り替えダイアログ非表示（切り替え不可）
    • 【表示例2】
      URL1：http://×××, LABEL1:高, DESC1:(300kbps)
      URL2：http://○○○, LABEL2:中, DESC2:(200kbps)
      URL3：設定なし
      表示例2の画像
    • 【表示例3】
      URL1：http://×××, LABEL1:高, DESC1:(300kbps)
      URL2：（設定なし）
      URL3：http://◇◇◇, LABEL3:低, DESC3:(100kbps)
      表示例3の画像
    • 【表示例4】
      URL1：http://×××, LABEL1:高, DESC1:(300kbps)
      URL2: http://○○○, LABEL2:中, DESC2:(200kbps)
      URL3: http://◇◇◇, LABEL3:低, DESC3:(100kbps)
      表示例4の画像
  • 注意6 DEFAULT_PLAYが指定されなかった場合、もしくは1〜3以外の値が指定された場合はURL1の再生を開始します。
    （音楽コンテンツでは使用されません。）
  • 注意7 CONTENT_TYPEが指定されなかった場合、もしくは無効であった場合は、実体が音楽コンテンツであっても動画プレイヤーで再生を行います。

このページのトップへ

フッターナビゲーション