ByteArrayAsset

Pacote	mx.core
Classe	public class ByteArrayAsset
Herança	ByteArrayAsset ByteArray Object
Implementações	IFlexAsset

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flex 3

Versões de runtime:

Flash Player 9, AIR 1.1

ByteArrayAsset is a subclass of the flash.utils.ByteArray class which represents an arbitrary sequence of byte data that you embed in a Flex application.

The byte data that you are embedding can be in any kind of file, and the entire file is always embedded. You cannot embed the bytes of a particular asset that is in a SWF file, although you can embed an entire SWF file.

The MXML compiler autogenerates a class that extends ByteArrayAsset to represent the embedded data.

To embed an arbitrary file, you declare a variable of type Class, and put [Embed] metadata on it, using the MIME type application/octet-stream. For example, you embed a text file like this:

  [Bindable]
  [Embed(source="Story.txt", mimeType="application/octet-stream")]
  private var storyClass:Class;

The compiler autogenerates a subclass of the ByteArrayAsset class and sets your variable to be a reference to this autogenerated class. You can then use this class reference to create instances of the ByteArrayAsset using the new operator, and you can extract information from the byte array using methods of the ByteArray class:

  var storyByteArray:ByteArrayAsset = ByteArrayAsset(new storyClass());
  var story:String = storyByteArray.readUTFBytes(storyByteArray.length);

You must specify that the MIME type for the embedding is application/octet-stream, which causes the byte data to be embedded "as is", with no interpretation. It also causes the autogenerated class to extend ByteArrayAsset rather than another asset class.

For example, if you embed a PNG file without specifying this MIME type, the PNG data will be automatically transcoded into the bitmap format used by the player, and a subclass of BitmapAsset will be autogenerated to represent it. But if you specify the MIME type as application/octet-stream, then no transcoding will occur, the PNG data will be embedded as is, and the autogenerated class will extend ByteArrayAsset.

Propriedades públicas

Ocultar propriedades públicas herdadas

Mostrar propriedades públicas herdadas

	Propriedade		Definido por
		bytesAvailable : uint [somente leitura] O número de bytes de dados disponíveis para leitura da posição atual na matriz de bytes até o final dessa matriz.	ByteArray
		constructor : Object Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto.	Object
		endian : String Altera ou faz a leitura da ordem de bytes para os dados; seja Endian.BIG_ENDIAN ou Endian.LITTLE_ENDIAN.	ByteArray
		length : uint O comprimento do objeto ByteArray, em bytes.	ByteArray
		objectEncoding : uint Usada para determinar se o formato ActionScript 3.0, ActionScript 2.0 ou ActionScript 1.0 deve ser usado ao gravar em, ou ler de, uma ocorrência de ByteArray.	ByteArray
		position : uint Move, ou retorna a posição atual, em bytes, do ponteiro de arquivo no objeto ByteArray.	ByteArray
		shareable : Boolean Especifica se a memória subjacente da matriz de bytes é compartilhável	ByteArray

Métodos públicos

Ocultar métodos públicos herdados

Mostrar métodos públicos herdados

	Método		Definido por
		ByteArrayAsset() Constructor.	ByteArrayAsset
		atomicCompareAndSwapIntAt(byteIndex:int, expectedValue:int, newValue:int):int Em uma única operação atômica, ela compara um valor inteiro nesta matriz de bytes a outro valor inteiro. Se forem compatíveis, troque estes bytes por outros valores.	ByteArray
		atomicCompareAndSwapLength(expectedLength:int, newLength:int):int Em uma operação atômica simples, ele compara o comprimento da matriz de bytes com o valor fornecido e, se forem correspondentes, altera o comprimento desta matriz de bytes.	ByteArray
		clear():void Limpa o conteúdo da matriz de bytes e redefine as propriedades length e position como 0.	ByteArray
		compress(algorithm:String):void Compacta a matriz de bytes.	ByteArray
		deflate():void Compacta a matriz de bytes usando o algoritmo de compactação deflate.	ByteArray
		hasOwnProperty(name:String):Boolean Indica se um objeto tem uma propriedade especificada definida.	Object
		inflate():void Descompacta a matriz de bytes usando o algoritmo de compactação deflate.	ByteArray
		isPrototypeOf(theClass:Object):Boolean Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro.	Object
		propertyIsEnumerable(name:String):Boolean Indica se a propriedade especificada existe e é enumerável.	Object
		readBoolean():Boolean Lê um valor booliano do fluxo de bytes.	ByteArray
		readByte():int Lê um byte assinado do fluxo de bytes.	ByteArray
		readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void Lê o número de bytes de dados especificados pelo parâmetro de comprimento a partir do fluxo de bytes.	ByteArray
		readDouble():Number Lê um número de ponto flutuante de precisão dupla (64 bits) IEEE 754 do fluxo de bytes.	ByteArray
		readFloat():Number Lê um número de ponto flutuante de precisão única (32 bits) IEEE 754 do fluxo de bytes.	ByteArray
		readInt():int Lê um inteiro de 32 bits assinado do fluxo de bytes.	ByteArray
		readMultiByte(length:uint, charSet:String):String Lê uma string de vários bytes de comprimento especificado, do fluxo de bytes, usando o conjunto de caracteres especificado.	ByteArray
		readObject():* Lê um objeto da matriz de bytes, codificado no formato serializado AMF.	ByteArray
		readShort():int Lê um inteiro de 16 bits assinado do fluxo de bytes.	ByteArray
		readUnsignedByte():uint Lê um byte não assinado do fluxo de bytes.	ByteArray
		readUnsignedInt():uint Lê um inteiro de 32 bits não assinado do fluxo de bytes.	ByteArray
		readUnsignedShort():uint Lê um inteiro de 16 bits não assinado do fluxo de bytes.	ByteArray
		readUTF():String Lê uma string UTF-8 do fluxo de bytes.	ByteArray
		readUTFBytes(length:uint):String Lê uma sequência de bytes UTF-8 especificados pelo parâmetro de comprimento, do fluxo de bytes e retorna uma string.	ByteArray
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Define a disponibilidade de uma propriedade dinâmica para operações de repetição.	Object
		toJSON(k:String):* Fornece um método substituível para personalizar a codificação de JSON dos valores em um objeto ByteArray.	ByteArray
		toLocaleString():String Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade.	Object
		toString():String Converte a matriz de bytes em uma string.	ByteArray
		uncompress(algorithm:String):void Descompacta a matriz de bytes.	ByteArray
		valueOf():Object Retorna o valor primitivo do objeto especificado.	Object
		writeBoolean(value:Boolean):void Grava um valor booliano.	ByteArray
		writeByte(value:int):void Grava um byte no fluxo de bytes.	ByteArray
		writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void Grava uma sequência de bytes de comportamento, de uma matriz de bytes especificada, iniciando com bytes de deslocamento (índice com base zero) no fluxo de bytes.	ByteArray
		writeDouble(value:Number):void Grava no fluxo de bytes um número de ponto flutuante de precisão dupla (64 bits) IEEE 754.	ByteArray
		writeFloat(value:Number):void Grava no fluxo de bytes um número de ponto flutuante de precisão única (32 bits) IEEE 754.	ByteArray
		writeInt(value:int):void Grava um inteiro assinado de 32 bits no fluxo de bytes.	ByteArray
		writeMultiByte(value:String, charSet:String):void Grava uma string de vários bytes no fluxo de bytes, usando o conjunto de caracteres especificado.	ByteArray
		writeObject(object:*):void Grava um objeto na matriz de bytes no formato serializado AMF.	ByteArray
		writeShort(value:int):void Grava um inteiro de 16 bits no fluxo de bytes.	ByteArray
		writeUnsignedInt(value:uint):void Grava um inteiro não assinado de 32 bits no fluxo de bytes.	ByteArray
		writeUTF(value:String):void Grava uma string UTF-8 no fluxo de bytes.	ByteArray
		writeUTFBytes(value:String):void Grava uma string UTF-8 no fluxo de bytes.	ByteArray

Detalhes do construtor

()

Construtor

public function ByteArrayAsset()

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flex 3

Versões de runtime:

Flash Player 9, AIR 1.1

Constructor.

Aspectos jurídicos | Política de privacidade on-line

ByteArrayAsset - AS3 Flex

Pacotesx

Elementos de linguagem

Apêndices

Pacote mx.core

ByteArrayAsset