Formato da mensagem de ação - Action Message Format

O Action Message Format ( AMF ) é um formato binário usado para serializar gráficos de objetos, como objetos ActionScript e XML, ou enviar mensagens entre um cliente Adobe Flash e um serviço remoto, geralmente um Flash Media Server ou alternativas de terceiros. A linguagem Actionscript 3 fornece classes para codificação e decodificação do formato AMF.

O formato é frequentemente usado em conjunto com o RTMP da Adobe para estabelecer conexões e controlar comandos para a entrega de mídia de streaming. Nesse caso, os dados AMF são encapsulados em um bloco que possui um cabeçalho que define coisas como o comprimento e o tipo da mensagem (seja um "ping", "comando" ou dados de mídia).

Análise de formato

O AMF foi introduzido com o Flash Player 6 e esta versão é conhecida como AMF0. Ele permaneceu inalterado até o lançamento do Flash Player 9 e ActionScript 3.0, quando novos tipos de dados e recursos de linguagem solicitaram uma atualização, chamada AMF3. O Flash Player 10 adicionou tipos de dados vetoriais e de dicionário documentados em uma especificação revisada de janeiro de 2013.

A Adobe Systems publicou a especificação do protocolo de dados binários AMF em dezembro de 2007 e anunciou que apoiará a comunidade de desenvolvedores a disponibilizar este protocolo para todas as principais plataformas de servidor.

Pacote autocontido AMF

O pacote amf a seguir é para transmissão de mensagens fora de contêineres Adobe / Macromedia definidos ou transportes, como Flash Video ou Real Time Messaging Protocol .

Se o comprimento do cabeçalho ou o comprimento da mensagem forem desconhecidos, eles serão definidos como -1 ou 0xFFFFFFFF

uimsbf: inteiro sem sinal, o bit mais significativo primeiro

simsbf: inteiro com sinal, o bit mais significativo primeiro

AMF0

O formato especifica os vários tipos de dados que podem ser usados ​​para codificar dados. A Adobe afirma que AMF é usado principalmente para representar gráficos de objetos que incluem propriedades nomeadas na forma de pares de valores-chave, onde as chaves são codificadas como strings e os valores podem ser de qualquer tipo de dados, como strings ou números, bem como matrizes e outros objetos. XML é suportado como um tipo nativo. Cada tipo é denotado por um único byte precedendo os dados reais. Os valores desse byte são os seguintes (para AMF0):

• Número - 0x00 (codificado como número de ponto flutuante de precisão dupla IEEE de 64 bits )
• Booleano - 0x01 (codificado como um único byte de valor 0x00 ou 0x01)
• String - 0x02 (comprimento de string inteiro de 16 bits com string UTF-8)
• Objeto - 0x03 (conjunto de pares chave / valor)
• Nulo - 0x05
• Matriz ECMA - 0x08 (contagem de entrada de 32 bits)
• Object End - 0x09 (precedido por um comprimento de string vazio de 16 bits)
• Matriz estrita - 0x0a (contagem de entrada de 32 bits)
• Data - 0x0b (codificado como número de ponto flutuante de precisão dupla IEEE de 64 bits com deslocamento de fuso horário inteiro de 16 bits)
• String longa - 0x0c (comprimento de string inteiro de 32 bits com string UTF-8)
• Documento XML - 0x0f (comprimento de string inteiro de 32 bits com string UTF-8)
• Objeto digitado - 0x10 (comprimento do nome inteiro de 16 bits com nome UTF-8, seguido por entradas)
• Mudar para AMF3 - 0x11

Os objetos AMF começam com (0x03) seguido por um conjunto de pares de valores-chave e terminam com (0x09) como valor (precedido por 0x00 0x00 como entrada de chave vazia). As chaves são codificadas como strings com o byte de 'definição de tipo' (0x02) implícito (não incluído na mensagem). Os valores podem ser de qualquer tipo, incluindo outros objetos, e gráficos de objetos inteiros podem ser serializados dessa maneira. Ambas as chaves de objeto e strings são precedidas por dois bytes que denotam seu comprimento em número de bytes. Isso significa que as strings são precedidas por um total de três bytes, que inclui o byte do tipo 0x02. Os tipos nulos contêm apenas sua definição de tipo (0x05). Os números são codificados como ponto flutuante de precisão dupla e são compostos por oito bytes.

Por exemplo, ao codificar o objeto abaixo no código actionscript 3.

var person:Object = {name:'Mike', age:'30', alias:'Mike'};
var stream:ByteArray = new ByteArray();
stream.objectEncoding = ObjectEncoding.AMF0; // ByteArray defaults to AMF3
stream.writeObject(person);

Os dados mantidos no ByteArray são:

Nota: as propriedades do objeto podem ser classificadas em uma ordem diferente daquela em que são colocadas no Actionscript. Para colorir / marcar, consulte a legenda abaixo.

O código acima funcionará apenas para classes integradas como Object . Para serializar e desserializar classes personalizadas, o usuário precisa declará-las usando o comando registerClassAlias ​​ou então um erro será gerado pelo player.

// for a hypothetical class Person
registerClassAlias("personTypeAlias", Person);

Embora, estritamente falando, AMF seja apenas um formato de codificação de dados, geralmente é encontrado encapsulado em uma mensagem RTMP ou chamada Flex RPC. Um exemplo do primeiro pode ser encontrado abaixo (é a mensagem "_result" retornada em resposta ao comando "conectar" enviado do cliente flash):

legenda: objeto de início / fim de objeto chaves valores de objeto ecma_array

A mensagem AMF começa com um 0x03 que denota um pacote RTMP com tipo de cabeçalho de 0 , portanto, 12 bytes são esperados a seguir. É do tipo de mensagem 0x14, que denota um comando na forma de uma string de valor "_result" e dois objetos serializados como argumentos. A mensagem pode ser decodificada da seguinte forma:

(command) "_result"
(transaction id) 1
(value)
[1] { fmsVer: "FMS/3,5,5,2004"
        capabilities: 31.0
        mode: 1.0 },
[2] { level: "status",
        code: "NetConnection.Connect.Success",
        description: "Connection succeeded.",
        data: (array) {
               version: "3,5,5,2004" },
        clientId: 1584259571.0,
        objectEncoding: 3.0 }

Aqui pode-se ver um array (em turquesa) como um valor da chave 'data' que tem um membro. Podemos ver o valor de objectEncoding como 3. Isso significa que as mensagens subsequentes serão enviadas com o tipo de mensagem 0x11, o que implicará em uma codificação AMF3.

AMF3

A versão mais recente do protocolo especifica mudanças significativas que permitem um formato mais compactado. Os marcadores de dados são os seguintes:

• Indefinido - 0x00
• Nulo - 0x01
• Boolean False - 0x02
• Boolean True - 0x03
• Inteiro - 0x04 (inteiro expansível de 8+ bits)
• Duplo - 0x05 (codificado como número de ponto flutuante de precisão dupla IEEE de 64 bits )
• String - 0x06 (comprimento de string inteiro expansível de 8+ bits com uma string UTF-8)
• XMLDocument - 0x07 (comprimento de string inteiro expansível de 8+ bits e / ou sinalizadores com uma string UTF-8)
• Data - 0x08 (sinalizadores de número inteiro expansível de 8+ bits com ponto flutuante de precisão dupla IEEE de 64 bits com tempo de deslocamento UTC)
• Matriz - 0x09 (contagem de entrada de inteiro expansível de 8+ bits e / ou sinalizadores com comprimentos de nome de inteiro opcional expansível de 8+ bits com nomes UTF-8)
• Objeto - 0x0A (contagem de entrada de inteiro expansível de 8+ bits e / ou sinalizadores com comprimentos de nome de inteiro opcional expansível de 8+ bits com nomes UTF-8)
• XML - 0x0B (sinalizadores de número inteiro expansível de 8+ bits)
• ByteArray - 0x0C (sinalizadores inteiros expansíveis de 8+ bits com comprimento de byte opcional de 8 bits)

Os primeiros 4 tipos não são seguidos por nenhum dado (os booleanos têm dois tipos no AMF3).

Os marcadores adicionais usados ​​pelo Flash Player 10 (o formato ainda é conhecido como AMF3) são os seguintes:

• VectorInt - 0x0D
• VectorUInt - 0x0E
• VectorDouble - 0x0F
• VectorObject - 0x10
• Dicionário - 0x11

O AMF3 visa a maior compactação e uma das maneiras de conseguir isso é evitando a duplicação de strings, salvando-os em um array no qual todos os novos strings são verificados. O byte após o marcador de string não está mais denotando comprimento puro, mas é um byte complexo onde o bit menos significativo indica se a string está 'inline' (1) ou seja, não está na matriz ou 'referência' (0), caso em que o índice da matriz é salvo. A tabela inclui chaves e também valores.

Em versões anteriores do Flash player, existia um tipo de número chamado 'Número', que era uma codificação de precisão dupla de 64 bits. Nas versões mais recentes, há um int e um uint que estão incluídos no AMF3 como tipos separados. Os tipos de número são idênticos à codificação AMF0, enquanto os inteiros têm comprimento variável de 1 a 4 bytes, onde o bit mais significativo dos bytes 1-3 indica que eles são seguidos por outro byte.

Suporte para AMF

Os vários protocolos AMF são suportados por muitas linguagens e tecnologias do lado do servidor, na forma de bibliotecas e serviços que devem ser instalados e integrados pelo desenvolvedor do aplicativo.

Plataformas:

• ColdFusion -
• Haxe - Haxe Remoting hxformat
• Java - Adobe BlazeDS , Adobe LiveCycle Data Services (anteriormente conhecido como Flex Data Services) , Exadel Flamingo , RED 5 , Cinnamon , OpenAMF , Pimento , Granite , WebORB para Java
• .NET - WebORB para .NET , FluorineFx (LGPL), DotAmf (MS-PL), AMF.NET (desenvolvimento interrompido)
• PHP - AmfPHP , SabreAMF , WebORB para PHP , Zend_Amf , extensão php-amf3 , Baguette AMF (extensão php)
• Python - amfast
• Perl - AMF :: Perl , Storable :: AMF , AMF :: Connection
• Curl - Curl Data Services
• Ruby - RubyAMF , WebORB para Rails , Rocket AMF
• Erlang - Erlang-AMF
• ActionScript - Flash Player ByteArray (embutido), Biblioteca CourseVector
• JavaScript - JSAMF CourseVector Library CourseVector .minerva
• Lua - lua-amf3
• ABAP - ABAP AMF (estágio inicial)
• Delphi - kbmMW (amplo suporte AMF0 / AMF3)
• iOS - CocoaAMF
• PowerShell - Powershell AMF

Frameworks:

• Comunicação do Apache Royale com AMF e RemoteObject - Apache Royale
• Ruby on Rails - RubyAMF
• Zend Framework - Zend_AMF
• Estrutura OSGi - AMF3 para OSGi
• Django - Django AMF
• CakePHP - CakeAMFPHP
• Grails (framework) - BlazeDS
• Trac - TracRpcProtocolsPlugin . A versão 1.1.0 (ou superior) do XmlRpcPlugin é necessária.
• Web2py - PyAMF

Veja também

• BSON
• Buffers de protocolo

Referências

GB