Package	com.curlyben.media
Class	public class ID3TagReader
Inheritance	ID3TagReader flash.events.EventDispatcher

ID3TagReader allows:
• Cross domain tag reading¹
• Read access to all specification compliant ID3 frames²
• Read access to embedded artwork frames

How to extract information from ID3 tags:

 var id3reader:ID3TagReader = new ID3TagReader();
 id3reader.addEventListener(ID3TagReader.EV_TAGFOUND, tagFoundHandler);
 
 ...
 
 private function tagFoundHandler(event:ID3Event):void {
  if(parseFloat(event.ID3Tag.version) >= 2.0)
   // handle 2.x tag
  else
   // handle 1.x tag
 }
 

• ID3Event.ID3Tag.texts
  
  
  Definition: Array<{id:String, value:String}>
  
  
  The id property of the objects in the ID3Tag.texts array corresponds directly to the four character frame identifiers in the repective ID3 specification.
  The value property of the objects in the ID3Tag.texts array contains the value of the corresponding frame in the resources ID3 tag.
  Common frames are mapped to common names (album, songName etc.) but are also available in the ID3Tag.texts array.
  
  
  Helper function: ID3Tag.GetText(id:String/RegExp):{id:String, value:String}

     public function Main():void {
      var tagger:ID3TagReader = new ID3TagReader();
      tagger.addEventListener(ID3TagReader.EV_TAGFOUND, id3EventHandler);
      tagger.ReadTag(new URLRequest("http://domain.tld/one_minute.mp3"));
     }
     ...
     private function id3EventHandler(event:ID3Event):void {
      var tlen:uint = parseInt(event.ID3Tag.GetText("TLEN").value);
      trace(tlen); // "60000"
     }
     

  
  
  
• ID3Event.ID3Tag.pictures
  
  
  Definition: Array<{mimetype:String, picturetype:String, description:String, picture:ByteArray}>
  
  
  The mimetype property of the objects in the ID3Tag.pictures array contains a string reflecting an IANA MIME type.
  The picturetype property of the objects in the ID3Tag.pictures array contains a string representing the associated pictures intended catagory/type according to the ID3 specification. The strings cover and inlay are examples of such values.
  The description property of the objects in the ID3Tag.pictures array contains the description associated with the picture, in cases where such meta data is provided. Not all picture frames will include descriptions.
  The picture property of the objects in the ID3Tag.pictures array contains the bytes that would usually be contained in the picture file, were it located in an offline filesystem. This data can be loaded into containers that support byte loading such as flash.display.Loader and the method loadBytes.
  
  Helper function: ID3Tag.GetPicture(picturetype:String/RegExp):{mimetype:String, picturetype:String, description:String, picture:ByteArray}

     public var picloader:Loader;
     public function Main():void {
      var tagger:ID3TagReader = new ID3TagReader();
      tagger.addEventListener(ID3TagReader.EV_TAGFOUND, id3EventHandler);
      tagger.ReadTag(new URLRequest("http://domain.tld/one_minute.mp3"));
     }
     ...
     private function id3EventHandler(event:ID3Event):void {
      var picbytes:ByteArray = event.ID3Tag.GetPicture(/cover/i).picture;
      this.picloader = new Loader();
      this.picloader.loadBytes(picbytes);
     }
     

  
  
  
• ID3Event.ID3Tag.comments
  
  
  Definition: Array<{language:String, description:String, value:String}>
  
  
  The language property of the objects in the ID3Tag.comments array contains the three character ISO-639-2 language code, indicating the language of the comment description and value.
  The description property of the objects in the ID3Tag.comments array contains a string describing the value of the value property. Not all comment frames may have a description.
  The value property of the objects in the ID3Tag.comments array contains the frames comment text. Not all comment frames may have a value.
  
  Helper function: GetComment(description:String/RegExp):{language:String, description:String, value:String}

     public function Main():void {
      var tagger:ID3TagReader = new ID3TagReader();
      tagger.addEventListener(ID3TagReader.EV_TAGFOUND, id3EventHandler);
      tagger.ReadTag(new URLRequest("http://domain.tld/one_minute.mp3"));
     }
     ...
     private function id3EventHandler(event:ID3Event):void {
      var license:String = event.ID3Tag.GetComment(/license/i).value;
      trace(license); // "Creative Commons BY 3.0 Unported"
     }
     

  
  
  
• ID3Event.ID3Tag.links
  
  
  Definition: Array<{id:String, value:String}>³
  
  
  The id property of the objects in the ID3Tag.links array corresponds directly to the four character frame identifiers in the repective ID3 specification.
  The value property of the objects in the ID3Tag.links array contains the value of the corresponding frame in the resources ID3 tag. This value is often an absolute URL, although the ID3 specification allows for relative URLs
  
  Helper function: GetLink(id:String/RegExp):{id:String, value:String}

     public textField:TextField;
     public function Main():void {
      var tagger:ID3TagReader = new ID3TagReader();
      tagger.addEventListener(ID3TagReader.EV_TAGFOUND, id3EventHandler);
      tagger.ReadTag(new URLRequest("http://domain.tld/one_minute.mp3"));
      ...
     }
     ...
     private function id3EventHandler(event:ID3Event):void {
      // "WOAF" is the frame ID for the ID3v2.3.0
      // specification official audio file webpage.
      var url:String = event.ID3Tag.GetLink("WOAF").value;
      textField.htmlText = "<a href=' + url + ' target='_blank'>Related Link</a>";
     }
     

  
  
  

How to extract information from icecast/shoutcast tags:

 var id3reader:ID3TagReader = new ID3TagReader();
 id3reader.addEventListener(ID3TagReader.EV_ICYMETAFOUND, tagFoundHandler);
 
 ...
 
 private function tagFoundHandler(event:ID3Event):void {
   trace("The StreamTitle is: " + event.ID3Tag.icy_streamtitle);
  ...
 }