Referência do ActionScript® 3.0 para Adobe® Flash® Platform
Início  |  Ocultar listas de Pacotes e Classes |  Pacotes  |  Classes  |  Novidades  |  Índice  |  Apêndices  |  Por que inglês?
Filtros: Recuperando dados do servidor...
Recuperando dados do servidor...
flash.profiler 

Telemetry  - AS3

Pacoteflash.profiler
Classepublic final class Telemetry
HerançaTelemetry Inheritance Object

Versão da linguagem: ActionScript 3.0
Versões de runtime: Flash Player 11.4, AIR 3.4

A classe Telemetry permite um código do perfil do aplicativo do ActionScript e registra de manipuladores para os comandos



Propriedades públicas
 PropriedadeDefinido por
  connected : Boolean
[estático] [somente leitura] Indica se a Telemetria está conectada a um servidor
Telemetry
 Inheritedconstructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto.
Object
  spanMarker : Number
[estático] [somente leitura] Retorna um marcador para o uso com Telemetry.sendSpanMetric
Telemetry
Métodos públicos
 MétodoDefinido por
 Inherited
Indica se um objeto tem uma propriedade especificada definida.
Object
 Inherited
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro.
Object
 Inherited
Indica se a propriedade especificada existe e é enumerável.
Object
  
[estático] Registre uma função que pode ser chamada ao emitir um comando se um soquete retornar verdadeiro se o registro obtiver êxito.
Telemetry
  
sendMetric(metric:String, value:*):void
[estático] Solicita uma métrica personalizada da Telemetria.
Telemetry
  
sendSpanMetric(metric:String, startSpanMarker:Number, value:* = null):void
[estático] Requer uma métrica estendida personalizada do uso telemétrico Telemetry.spanMarker para fazer com que um marcador no início da função tenha um perfil e chame Telemetry.sendSpanMetric no final da função com o marcador.
Telemetry
 Inherited
Define a disponibilidade de uma propriedade dinâmica para operações de repetição.
Object
 Inherited
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade.
Object
 Inherited
Retorna a representação de string do objeto especificado.
Object
  
[estático]
Telemetry
 Inherited
Retorna o valor primitivo do objeto especificado.
Object
Detalhes da propriedade

connected

propriedade
connected:Boolean  [somente leitura]

Versão da linguagem: ActionScript 3.0
Versões de runtime: Flash Player 11.4, AIR 3.4

Indica se a Telemetria está conectada a um servidor



Implementação
    public static function get connected():Boolean

spanMarker

propriedade 
spanMarker:Number  [somente leitura]

Versão da linguagem: ActionScript 3.0
Versões de runtime: Flash Player 11.4, AIR 3.4

Retorna um marcador para o uso com Telemetry.sendSpanMetric



Implementação
    public static function get spanMarker():Number

Elementos da API relacionados

Detalhes do método

registerCommandHandler

()método
public static function registerCommandHandler(commandName:String, handler:Function):Boolean

Versão da linguagem: ActionScript 3.0
Versões de runtime: Flash Player 11.4, AIR 3.4

Registra uma função que pode ser chamada pela emissão de um comando por um soquete

Os retornos são true se o registro for bem-sucedido. Se o registro falhar, já há um manipulador registrado para o comando usado (ou o nome do comando começa com '.', que é reservado para uso interno de player) os manipuladores já registrados podem ter o seu registro cancelado usando unregisterCommandHandler antes de registrar outro manipulador.

O valor de retorno de função do manipulador é enviado como resultado do comando (tlm-response.result). A função do manipulador pode lançar Erro, se quiser enviar uma resposta de erro. Nesse caso, Error.message e Error.id são enviados como tlm-response.tlm-error.message e tlm-response.tlm-error.code, respectivamente. (tlm-response.result e tlm-response.tlm-error.data são enviados como nulos)

Parâmetros

commandName:String — A sequência de caracteres especifica um nome exclusivo (O comando sobre o soquete deve especificar essa sequência de caracteres como o nome do método). A diretriz deve seguir a notação de DNS inversa, que ajuda a evitar problemas com o namespace. Além disso, e nomes que iniciam com . são reservados para uso nativo.
 
handler:Function — Função a ser chamada quando receber um comando por Telemetria pelo soquete com o nome do método, conforme especificado no argumento functionId. O manipulador deve aceitar apenas um argumento de tipo Array (conforme definido por tlm-method.params no Protocolo de telemetria), enviado pelo servidor de Telemetria junto com o nome do método.

Retorna
Boolean

sendMetric

()método 
public static function sendMetric(metric:String, value:*):void

Versão da linguagem: ActionScript 3.0
Versões de runtime: Flash Player 11.4, AIR 3.4

Solicita uma métrica personalizada da Telemetria. O nome da métrica e do objeto são enviados segundo o formato de protocolo de Telemetria.

A orientação dos namespaces da métrica personalizada deve seguir a notação de DNS inversa, que ajuda a evitar conflitos de namespace.

Parâmetros

metric:String — Nome da métrica
 
value:* — Qualquer valor/objeto primitivo que contém os detalhes da métrica


Lança
ArgumentError — Se a métrica usa namespaces reservados como namespace nativo do Flash (por exemplo, se o nome da métrica começa com '.')

sendSpanMetric

()método 
public static function sendSpanMetric(metric:String, startSpanMarker:Number, value:* = null):void

Versão da linguagem: ActionScript 3.0
Versões de runtime: Flash Player 11.4, AIR 3.4

Solicita uma extensão métrica personalizada da Telemetria

Use Telemetry.spanMarker para fazer com que um marcador no início da função tenha um perfil e chame Telemetry.sendSpanMetric no final da função com o marcador. A telemetria envia o nome, o marcador inicial e a duração da função junto com o valor opcional, segundo o protocolo de Telemetria.

A orientação dos namespaces da métrica personalizada deve seguir a notação de DNS inversa, que ajuda a evitar conflitos de namespace.

As métricas de extensão para durações menores que um limite especificado, que podem ser controladas pelo Servidor de telemetria usando o Protocolo de telemetria, iriam ser ignoradas pela Telemetria (não será enviada ao Servidor de telemetria).

Parâmetros

metric:String — Nome da métrica
 
startSpanMarker:Number — Iniciar o marcador.
 
value:* (default = null) — Parâmetro opcional. Qualquer valor/objeto primitivo a ser enviado juntamente com o nome, o marcador e a duração


Lança
ArgumentError — Se a métrica usa namespaces reservados como namespace nativo do Flash (isto é, se o nome da métrica começa com '.')

Elementos da API relacionados

unregisterCommandHandler

()método 
public static function unregisterCommandHandler(commandName:String):Boolean

Parâmetros

commandName:String

Retorna
Boolean




[ X ]Por que inglês?
O conteúdo na Referência do ActionScript 3.0 aparece em inglês

Nem todas as partes da Referência do ActionScript 3.0 estão traduzidas em todos os idiomas. Quando um elemento de um idioma não está traduzido, ele é exibido em inglês. Por exemplo, a classe ga.controls.HelpBox não está traduzida em nenhum idioma. Por isso, na versão da referência em português do Brasil, a classe ga.controls.HelpBox é exibida em inglês.