id3 (Sound.id3 プロパティ)

public id3 : Object (読み取り専用)

MP3 ファイルの一部であるメタデータに対するアクセスを提供します。

MP3 サウンドファイルには、ファイルについてのメタデータを示す ID3 タグを含めることができます。Sound.attachSound() または Sound.loadSound() を使用してロードした MP3 サウンドに ID3 タグが含まれる場合は、これらのプロパティを調べることができます。サポートされているのは、UTF-8 文字セットを使用する ID3 タグだけです。

Flash Player 6 (6.0.40.0) 以降は、ID3 1.0 および ID3 1.1 のタグをサポートするために、Sound.id3 プロパティを使用しています。Flash Player 7 では、ID3 2.0 (厳密には 2.3 および 2.4) のタグのサポートが追加されました。次の表に、標準の ID3 2.0 タグと、そのタグが表すコンテンツタイプを示します。これらを調べるには、my_sound.id3.COMM、my_sound.id3.TIME などの形式を使用します。MP3 ファイルには、この表に示していないタグも含めることができます。Sound.id3 を使用すると、それらのタグにもアクセスできます。

プロパティ

説明

TFLT

ファイル形式

TIME

時刻

TIT1

内容の属するグループの説明

TIT2

タイトル/曲名/内容の説明

TIT3

サブタイトル/説明の追加情報

TKEY

最初の調

TLAN

言語

TLEN

長さ

TMED

メディアタイプ

TOAL

オリジナルのアルバム/ムービー/ショーのタイトル

TOFN

オリジナルのファイル名

TOLY

オリジナルの作詞家/文書作成者

TOPE

オリジナルのアーティスト/演奏者

TORY

オリジナルのリリース年

TOWN

ファイルの所有者/ライセンス保持者

TPE1

主な演奏者/ソリスト

TPE2

バンド/オーケストラ/伴奏

TPE3

指揮者/演奏者詳細情報

TPE4

翻訳、リミックス、その他の修正を行った人

TPOS

セット中の位置

TPUB

発行者

TRCK

トラック番号/セット内の位置

TRDA

録音日

TRSN

インターネットラジオ局の名前

TRSO

インターネットラジオ局の所有者

TSIZ

サイズ

TSRC

ISRC (国際標準録音資料コード)

TSSE

エンコードに使用したソフトウェア/ハードウェアと設定

TYER

WXXX

URL link frame


Flash Player 6 は、いくつかの ID31.0 タグをサポートしていました。MP3 ファイル内にこれらのタグがなく、対応する ID3 2.0 タグがある場合は、ID3v2 タグが ID3v1 のプロパティにコピーされます。次の表は、ID3 2.0 タグから ID3 1.0 プロパティへの対応を示しています。このプロセスによって、ID3 1.0 のプロパティを読み取るように作成された既存のスクリプトとの後方互換性が維持されます。

ID3 2.0 タグ

対応する ID3 1.0 プロパティ

COMM

Sound.id3.comment

TALB

Sound.id3.album

TCON

Sound.id3.genre

TIT2

Sound.id3.songname

TPE1

Sound.id3.artist

TRCK

Sound.id3.track

TYER

Sound.id3.year


使用できるバージョン : ActionScript 1.0、Flash Lite 2.0

次の例は、song.mp3 の ID3 プロパティを追跡して [出力] パネルに表示します。

var my_sound: Sound = new Sound();
my_sound.onID3 = function(){
    for( var prop in my_sound.id3 ){
    trace( prop + " : "+ my_sound.id3[prop] );
    }
}
my_sound.loadSound("song.mp3", false);

関連項目

attachSound (Sound.attachSound メソッド), loadSound (Sound.loadSound メソッド)