FLVPlayback  - AS3 Flash

Um número que especifica qual ocorrência do player de vídeo é afetada por outras APIs (interfaces de programação de aplicativo). Use esta propriedade para gerenciar vários fluxos de arquivo FLV.

Esta propriedade não torna o player de vídeo visível; use a propriedade visibleVideoPlayerIndex para fazer isso.

É criado um novo player de vídeo na primeira vez em que activeVideoPlayerIndex é definido como número. Quando o novo player de vídeo for criado, suas propriedades são definidas como o valor do player de vídeo padrão (activeVideoPlayerIndex == 0), exceto para source, totalTime e isLive, que são sempre definidas como valores padrão (string vazia, NaN e false, respectivamente), e autoPlay, que é sempre false (o padrão é true apenas para o player de vídeo padrão, 0). A propriedade cuePoints não tem efeito, pois não teria efeito em uma carga subsequente no player de vídeo padrão.

As APIs que controlam volume, posicionamento, dimensões, visibilidade e controles de UI são sempre globais, e seu comportamento não é afetado pela definição do activeVideoPlayerIndex. Especificamente, a definição da propriedade activeVideoPlayerIndex não afeta as seguintes propriedades e métodos:

Nota: a propriedade visibleVideoPlayerIndex, não a propriedade activeVideoPlayerIndex, determina qual player de vídeo a transparência controla. Além disso, as APIs que controlam as dimensões interagem com a propriedade visibleVideoPlayerIndex.

As APIs restantes focalizam-se em um player de vídeo específico baseado na configuração de activeVideoPlayerIndex.

Para carregar um segundo arquivo FLV em segundo plano, configure activeVideoPlayerIndex como 1 e chame o método load(). Quando você estiver pronto para mostrar este arquivo FLV e ocultar o primeiro, configure visibleVideoPlayerIndex como 1.

O valor padrão é 0.

Elementos da API relacionados

Especifica o layout de vídeo quando a propriedade scaleMode está definida como VideoScaleMode.MAINTAIN_ASPECT_RATIO ou VideoScaleMode.NO_SCALE. As dimensões do vídeo se baseiam nas propriedades registrationX, registrationY, registrationWidth e registrationHeight. Quando você configura a propriedade align, os valores vêm da classe VideoAlign. O padrão é VideoAlign.CENTER.

Elementos da API relacionados

Um valor booliano que, se definido como true, faz com que o arquivo FLV comece a reproduzir automaticamente após a definição da propriedade source. Caso seja definido como false, o arquivo FLV é carregado, mas só começa a reprodução quando o método play() ou playWhenEnoughDownloaded() é chamado.

A reprodução começa imediatamente quando você está fazendo streaming de um arquivo FLV do Flash Media Server (FMS) e a propriedade autoPlay for configurada como true. No entanto, ao carregar um arquivo FLV por download progressivo, a reprodução só começa quando já baixou uma parte suficiente do arquivo FLV, para que este possa ser reproduzido do início ao fim.

Para forçar a reprodução antes que uma parte suficiente do arquivo FLV tenha sido baixada, chame o método play() sem parâmetros. Se a reprodução se inicia e você quer voltar para o estado de espera pelo tempo suficiente para baixar e depois iniciar automaticamente a reprodução, chame o método pause() e depois o método playWhenEnoughDownloaded().

Se você configurar a propriedade como true entre o carregamento dos novos arquivos FLV, ela não tem efeito até que a propriedade source seja configurada.

A configuração da propriedade autoPlay como true e depois a configuração da propriedade source como URL têm o mesmo efeito que chamar o método play() com essa URL.

A chamada ao método load() com uma URL tem o mesmo efeito que definir a propriedade source como aquela URL com a propriedade autoPlay configurada como false.

O valor padrão é true.

Elementos da API relacionados

Um valor booliano que, se true, faz com que o arquivo FLV retorne ao Quadro 1 quando a reprodução parar, seja porque o player atingiu o final do fluxo ou porque o método stop() foi chamado. Essa propriedade é insignificante para os fluxos ao vivo.

O valor padrão é false.

Controle de reprodução de BackButton. Quando se clica, o método seekToPrevNavCuePoint() é chamado.

Elementos da API relacionados

Um número que especifica os bits por segundos nos quais efetuar a transferência do arquivo FLV.

Ao realizar streaming de um serviço Flash Video Streaming que suporta a detecção de largura de banda nativa, você pode fornecer um arquivo SMIL que descreve como alternar entre vários fluxos baseados na largura de banda. Dependendo do seu FVSS, a largura de banda pode ser automaticamente detectada e, se esse valor for configurado, é ignorada.

Ao fazer o download progressivo HTTP, você pode usar o mesmo formato SMIL, mas você deve definir a taxa de bits já que não há detecção automática.

Um valor booliano que será true se o vídeo estiver em estado de buffer.

Controle da barra de buffer. Este controle é exibido quando o arquivo FLV se encontra em um estado de carregamento ou buffer.

Se definido como true, oculta o controle de SeekBar e desativa os controles de Play, Pause, PlayPause, BackButton e ForwardButton enquanto o arquivo FLV estiver no estado de buffer. Isso pode ser útil para impedir que o usuário use esses controles para tentar acelerar a reprodução do arquivo FLV quando estiver fazendo download ou streaming em uma conexão lenta.

Um número que especifica o número de segundos a ser armazenado temporariamente na memória antes de iniciar a reprodução de um fluxo de vídeo. Para realizar o streaming dos arquivos FLV sobre RTMP, que não são baixados e criam buffer apenas na memória, pode ser importante aumentar essa configuração a partir do valor padrão de 0,1. Para um arquivo FLV que é progressivamente baixado sobre HTTP, há pouca vantagem em aumentar este valor, embora possa melhorar a visualização do vídeo de alta qualidade em um computador mais lento e mais antigo.

No vídeo pré-gravado (não ao vivo), não configure a propriedade bufferTime como 0: use o tempo de buffer padrão ou aumente o tempo do buffer.

Essa propriedade não especifica o quanto do arquivo FLV precisa ser baixado antes de iniciar a reprodução.

O valor padrão é 0.1.

Elementos da API relacionados

Um número que indica a extensão do download, em número de bytes, para um download HTTP. Retorna 0 quando não houver fluxo, quando o fluxo for do Flash Media Server (FMS) ou se as informações ainda não estiverem disponíveis. O valor retornado é útil apenas para um download de HTTP.

Um número que especifica o número total de bytes baixados para um download HTTP. Retorna 0 quando não houver fluxo, quando o fluxo for do Flash Media Server (FMS) ou se as informações ainda não estiverem disponíveis. O valor retornado é útil apenas para um download de HTTP.

Uma matriz que descreve pontos de sinalização ActionScript e pontos de sinalização de arquivos FLV incorporados desativados. Essa propriedade é criada especificamente para ser usado pelo inspetor Component e pelo inspetor Property. Ela não funciona se for configurada de qualquer outra forma. Seu valor tem um efeito apenas no primeiro arquivo FLV e só é carregada ao se configurar a propriedade source no inspetor Component ou no inspetor Property.

Nota: essa propriedade não pode ser acessada no ActionScript. Para acessar as informações sobre o ponto de sinalização no ActionScript, use a propriedade metadata.

Para adicionar, remover, ativar ou desativar os pontos de sinalização com ActionScript, use os métodos addASCuePoint(), removeASCuePoint() ou setFLVCuePointEnabled().

Elementos da API relacionados

Retorna o próximo valor tabIndex disponível depois dos controles de FLVPlayback. O valor é definido depois que o método assignTabIndexes é chamado.

Elementos da API relacionados

Controle de botão Forward. Quando se clica, o método seekToNextNavCuePoint() é chamado.

Elementos da API relacionados

Cor de plano de fundo usada quando no modo de incorporação de tela cheia. Essa cor é visível se o vídeo não cobrir a tela inteira com base no valor da propriedade scaleMode.

O valor padrão é 0x000000.

Controle de botão FullScreen.

Especifica o tempo de atraso, em milésimos de segundo, para ocultar a cobertura. Quando se está no modo de incorporação de tela cheia, se a propriedade skinAutoHide for true, o ocultamento automático é acionado quando o usuário não movimenta o mouse por mais tempo do que os segundos indicados pela propriedade fullScreenSkinDelay. Se o mouse for sobre a própria transparência, o ocultamento automático não é disparado.

O valor padrão é 3000 milliseconds (3 seconds).

Quando o palco entrar no modo de tela cheia, o componente FLVPlayback estará no topo de todo o conteúdo e englobará a tela inteira. Quando o palco sair do modo de tela cheia, a tela volta para a forma que era antes.

As configurações recomendadas para o modo de incorporação de tela cheia são scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO e align = VideoAlign.CENTER.

Se o arquivo SWF com o componente FLVPlayback for carregado e não tiver acesso ao palco devido a restrições de segurança, o modo de incorporação de tela cheia não funciona. Não foram lançados erros.

O valor padrão é true.

Um número que especifica a altura da ocorrência de FLVPlayback. Essa propriedade afeta apenas a altura da ocorrência FLVPlayback e não inclui a altura do arquivo SWF da transparência que pode ser carregado. A configuração da propriedade de altura também configura a propriedade registrationHeight como o mesmo valor.

Elementos da API relacionados

A espaço de tempo, em milésimos de segundo, antes que o Flash finalize uma conexão inativa com o FMS (Flash Media Server) porque a reprodução foi pausada ou parada. Essa propriedade não tem efeito sobre o download de um arquivo FLV sobre HTTP.

Se essa propriedade for configurada quando um fluxo de vídeo já estiver ocioso, ele reinicia o período-limite com o novo valor.

O valor padrão é 300,000 milliseconds (5 minutes).

Elementos da API relacionados

Um valor booliano que será true se o fluxo de vídeo for ao vivo. Essa propriedade é eficaz apenas quando se realiza streaming do Flash Media Server (FMS) ou de outro Flash Video Streaming Service (FVSS). O valor desta propriedade é ignorado para um download HTTP.

Se você configurar essa propriedade entre o carregamento dos novos arquivos FLVs, ela não tem efeito até que a propriedade source seja configurada para o novo arquivo FLV.

Configure a propriedade isLive como false ao enviar um fluxo de vídeo pré-gravado para o player de vídeo e como true ao enviar dados em tempo real como transmissões ao vivo. Para obter um melhor desempenho ao configurar a propriedade isLive como false, não configure a propriedade bufferTime como 0.

Elementos da API relacionados

Um valor booliano que será true se o streaming do arquivo FLV estiver sendo feito a partir do Flash Media Server (FMS) usando RTMP. Seu valor é false para qualquer outra origem do arquivo FLV.

Elementos da API relacionados

Um objeto que é um pacote de informações de metadados recebido de uma chamada para o método de retorno de chamada NetSteam.onMetaData(), se disponível. Pronto quando o evento metadataReceived é despachado.

Se o arquivo FLV estiver codificado com o codificador Flash 8, a propriedade metadata contém as seguintes informações. Os arquivos FLV mais antigos contêm apenas os valores de height, width e duration.

Saiba mais

Elementos da API relacionados

Um valor booliano que será true se um pacote de metadados tiver sido encontrado e processado ou se o arquivo FLV tiver sido codificado sem o pacote de metadados. Em outras palavras, o valor é true se os metadados são recebidos, ou se você nunca for obter metadados. Assim, você sabe se tem os metadados; e, se não tiver os metadados, você sabe que não precisa esperar. Se você só quer saber se tem ou não os metadados, você pode verificar o valor com:

FLVPlayback.metadata != null

Use essa propriedade para verificar se pode recuperar informações úteis com os métodos para encontrar e ativar ou desativar os pontos de sinalização (findCuePoint, findNearestCuePoint, findNextCuePointWithName, isFLVCuePointEnabled).

Elementos da API relacionados

Controle de botão Mute.

Um objeto INCManager que fornece acesso a uma ocorrência da classe que implementa INCManager, que é uma interface com a classe NCManager.

Você pode usar essa propriedade para implementar um INCManager personalizado que exige inicialização personalizada.

Elementos da API relacionados

Controle de botão Pause.

Um valor booliano que será true se o arquivo FLV estiver no estado pausado.

Controle de botão Play.

Um número que especifica o playheadTime atual como porcentagem da propriedade totalTime. Se você acessar esta propriedade, ela contém a percentagem do tempo de reprodução decorrido. Se você definir esta propriedade, ela gera uma operação de busca até o ponto que representa essa percentagem do tempo de reprodução do arquivo FLV.

O valor desta propriedade se refere ao valor da propriedade totalTime.

Um número que corresponde à posição ou ao tempo atual do indicador de reprodução, medido em segundos, que pode ser um valor fracionário. A configuração desta propriedade dispara uma busca e tem todas as restrições de uma busca.

Quando o tempo do indicador de reprodução é alterado, que ocorre uma vez a cada 0,25 segundo, enquanto o arquivo FLV é reproduzido, o componente despacha o evento playheadUpdate.

Por várias razões, a propriedade playheadTime pode não ter o valor esperado depois que vocÊ chama um dos métodos de busca ou define playheadTime para gerar a busca. Em primeiro lugar, para um download progressivo, você só pode buscar em um quadro-chave, assim a busca leva você à hora do primeiro quadro-chave depois da hora especificada. (Ao realizar streaming, a busca sempre vai para a hora precisa especificada, mesmo que o arquivo FLV de destino não tenha um quadro-chave lá.) Em segundo lugar, a busca é assíncrona, por isso se você chamar um método de busca ou definir a propriedade playheadTime, playheadTime não é atualizado imediatamente. Para obter a hora depois que a busca é concluída, ouça o evento seek, que não é disparado até que a propriedade playheadTime seja atualizada.

Elementos da API relacionados

Um número que corresponde ao espaço de tempo, em milésimos de segundo, entre cada evento playheadUpdate. A configuração desta propriedade enquanto o arquivo FLV está sendo reproduzido reinicia o timer.

Como os pontos de sinalização ActionScript iniciam nas atualizações do indicador de reprodução, a redução do valor da propriedade playheadUpdateInterval pode aumentar a precisão dos pontos de sinalização ActionScript.

Como o intervalo de atualização do indicador de reprodução é configurado por uma chamada ao método global setInterval(), a atualização não pode ser acionada com mais frequência do que a taxa de quadros do arquivo SWF, como ocorre com qualquer intervalo que é configurado desta forma. Assim, como exemplo, para a taxa de quadro padrão de 12 quadros por segundo, o intervalo eficaz mais baixo que você pode criar é de aproximadamente 83 milissegundos, ou 1 segundo (1000 milissegundos) dividido por 12.

O valor padrão é 250.

Elementos da API relacionados

Um valor booliano que será true se o arquivo FLV estiver no estado em reprodução.

Controle de botão Play/pause.

Um número que especifica a altura do arquivo FLV de origem. Essa informação não é válida imediatamente na chamada dos métodos play() ou load(). É válido quando o evento ready se inicia. Se o valor da propriedade scaleMode for VideoScaleMode.MAINTAIN_ASPECT_RATIO ou VideoScaleMode.NO_SCALE, é melhor ler o valor depois que o evento layout é despachado. Essa propriedade retorna -1 caso ainda não haja informações.

Elementos da API relacionados

Fornece a largura do arquivo FLV de origem. Essa informação não é válida imediatamente quando são chamados os métodos play() ou load(); é válido depois que o evento ready é despachado. Se o valor da propriedade scaleMode for VideoScaleMode.MAINTAIN_ASPECT_RATIO ou VideoScaleMode.NO_SCALE, é melhor ler o valor depois que o evento layout é despachado. Essa propriedade retorna -1 caso ainda não haja informações.

Elementos da API relacionados

Apenas para visualização ao vivo. Lê em um arquivo PNG para a visualização.

Um número que corresponde ao espaço de tempo, em milésimos de segundo, entre cada evento progress. Se você definir esta propriedade enquanto o fluxo de vídeo estiver sendo reproduzido, o timer é reiniciado.

O valor padrão é 250.

Elementos da API relacionados

A altura usada para alinhar o conteúdo do vídeo ao efetuar o redimensionamento automático. Não confunda a propriedade registrationHeight com a propriedade height. A propriedade height reflete a altura real do conteúdo do vídeo.

Exemplo 1, carregue um arquivo FLV 80x80 com as seguintes configurações:

• registrationX = 100
• registrationY = 100
• registrationWidth = 60
• registrationHeight = 40
• align = VideoAlign.CENTER
• scaleMode = VideoScaleMode.NO_SCALE

• x = 90
• y = 80
• width = 80
• height = 80

Exemplo 2, carregue o mesmo cenário que o exemplo 1, mas com as seguintes configurações:

• scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO

• x = 110
• y = 100
• width = 40
• height = 80

Exemplo 3, carregue o mesmo cenário que o exemplo 2, mas com as seguintes configurações:

• scaleMode = VideoScaleMode.EXACT_FIT

• x = 100
• y = 100
• width = 60
• height = 40

A configuração da propriedade registrationHeight é equivalente à configuração da propriedade height e vice-versa. A configuração de qualquer outra propridade ou a chamada de qualquer método que altera a largura, como scaleX, setSize e setScale, também mantém height e registrationHeight em sincronização.

A largura usada para alinhar o conteúdo do vídeo ao efetuar o redimensionamento automático. Não confunda a propriedade registrationWidth com a propriedade width. A propriedade width reflete a largura real do conteúdo do vídeo.

Exemplo 1, carregue um arquivo FLV 80x80 com as seguintes configurações:

• registrationX = 100
• registrationY = 100
• registrationWidth = 60
• registrationHeight = 40
• align = VideoAlign.CENTER
• scaleMode = VideoScaleMode.NO_SCALE

• x = 90
• y = 80
• width = 80
• height = 80

Exemplo 2, carregue o mesmo cenário que o exemplo 1, mas com as seguintes configurações:

• scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO

• x = 110
• y = 100
• width = 40
• height = 80

Exemplo 3, carregue o mesmo cenário que o exemplo 2, mas com as seguintes configurações:

• scaleMode = VideoScaleMode.EXACT_FIT

• x = 100
• y = 100
• width = 60
• height = 40

A configuração da propriedade registrationWidth é equivalente à configuração da propriedade width e vice-versa. A configuração de qualquer outra propriedade ou a chamada de qualquer método que altera a largura, como scaleX, setSize e setScale, também mantém width e registrationWidth em sincronização.

A coordenada x usada para alinhar o conteúdo do vídeo ao efetuar o redimensionamento automático. Não confunda com a propriedade x, que reflete o local real do conteúdo do vídeo.

Exemplo 1, carregue um arquivo FLV 80x80 com as seguintes configurações:

• registrationX = 100
• registrationY = 100
• registrationWidth = 60
• registrationHeight = 40
• align = VideoAlign.CENTER
• scaleMode = VideoScaleMode.NO_SCALE

• x = 90
• y = 80
• width = 80
• height = 80

Exemplo 2, carregue o mesmo cenário que o exemplo 1, mas com as seguintes configurações:

• scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO

• x = 110
• y = 100
• width = 40
• height = 80

Exemplo 3, carregue o mesmo cenário que o exemplo 2, mas com as seguintes configurações:

• scaleMode = VideoScaleMode.EXACT_FIT

• x = 100
• y = 100
• width = 60
• height = 40

Quando uma das propriedades x ou registrationX for configurada, a segunda propriedade é alterada para manter sua compensação em relação à primeira. Por exemplo, se x = 10 e registrationX = 20, a configuração de x = 110 também define registrationX = 120.

A coordenada y usada para alinhar o conteúdo do vídeo ao efetuar o redimensionamento automático. Não confunda com a propriedade y, que reflete o local real do conteúdo do vídeo.

Exemplo 1, carregue um arquivo FLV 80x80 com as seguintes configurações:

• registrationX = 100
• registrationY = 100
• registrationWidth = 60
• registrationHeight = 40
• align = VideoAlign.CENTER
• scaleMode = VideoScaleMode.NO_SCALE

• x = 90
• y = 80
• width = 80
• height = 80

Exemplo 2, carregue o mesmo cenário que o exemplo 1, mas com as seguintes configurações:

• scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO

• x = 110
• y = 100
• width = 40
• height = 80

Exemplo 3, carregue o mesmo cenário que o exemplo 2, mas com as seguintes configurações:

• scaleMode = VideoScaleMode.EXACT_FIT

• x = 100
• y = 100
• width = 60
• height = 40

Quando uma das propriedades y ou registrationY for configurada, a segunda propriedade é alterada para manter sua compensação em relação à primeira. Por exemplo, se y = 10 e registrationY = 20, a configuração de y = 110 também define registrationY = 120.

Especifica como o vídeo será redimensionado após o carregamento. Se configurado como VideoScaleMode.MAINTAIN_ASPECT_RATIO, mantém a taxa de aspecto de vídeo no retângulo definido por registrationX, registrationY, registrationWidth e registrationHeight. Se configurado como VideoScaleMode.NO_SCALE, faz com que o vídeo seja automaticamente dimensionado de acordo com as dimensões do arquivo FLV de origem. Se configurado como VideoScaleMode.EXACT_FIT, faz com que as dimensões do arquivo FLV de origem sejam ignoradas e o vídeo é espichado para ajustar o retângulo definido por registrationX, registrationY, registrationWidth e registrationHeight. Se for configurado depois que o arquivo FLV foi carregado, será iniciado um layout automático imediatamente. Os valores vêm do VideoScaleMode.

O valor padrão é VideoScaleMode.MAINTAIN_ASPECT_RATIO.

Elementos da API relacionados