User Guide

ManualsBrandsMacromedia ManualsOtherFLASH MX 2004-ACTIONSCRIPT LANGUAGE REFERENCE

761

762

763

764

765

766

767

768

769

770

766 Chapter 2: ActionScript Language Reference

Sound.onID3

Availability

Flash Player 7.

Usage

my_sound.onID3 = function(){

// your statements here

}

Parameters

None.

Returns

Nothing.

Description

Event handler; invoked each time new ID3 data is available for an MP3 file that you load using

Sound.attachSound() or Sound.loadSound(). This handler provides access to ID3 data without

polling. If both ID3 1.0 and ID3 2.0 tags are present in a file, this handler is called twice.

Example

The following example displays the ID3 properties of song1.mp3 to an instance of the DataGrid

component. Add a DataGrid with the instance name

id3_dg to your document, and add the

following ActionScript to your FLA or AS file:

import mx.controls.gridclasses.DataGridColumn;

var id3_dg:mx.controls.DataGrid;

id3_dg.move(0, 0);

id3_dg.setSize(Stage.width, Stage.height);

var property_dgc:DataGridColumn = id3_dg.addColumn(new

DataGridColumn("property"));

property_dgc.width = 100;

property_dgc.headerText = "ID3 Property";

var value_dgc:DataGridColumn = id3_dg.addColumn(new DataGridColumn("value"));

value_dgc.width = id3_dg._width-property_dgc.width;

value_dgc.headerText = "ID3 Value";

var my_sound:Sound = new Sound();

my_sound.onID3 = function() {

trace("onID3 called at "+getTimer()+" ms.");

for (var prop in this.id3) {

id3_dg.addItem({property:prop, value:this.id3[prop]});

}

};

my_sound.loadSound("song1.mp3", true);