Pacote | flash.net |
Classe | public dynamic class NetStreamPlayOptions |
Herança | NetStreamPlayOptions EventDispatcher Object |
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
NetStream.play2()
. Transmita um objeto NetStreamPlayOptions para o play2()
e as propriedades da classe especificarão as diversas opções. Essa classe é usada principalmente para implementar transições entre fluxos, de forma dinâmica, para passar para fluxos de taxas de bits e tamanhos diferentes ou para mudar para outro conteúdo em uma lista de reprodução.
Propriedade | Definido por | ||
---|---|---|---|
constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | ||
len : Number
A duração da reprodução, em segundos, do fluxo especificado em streamName. | NetStreamPlayOptions | ||
offset : Number
O tempo de fluxo absoluto em que o servidor alterna entre fluxos de diferentes taxas de bits do fluxo dinâmico do Flash Media Server. | NetStreamPlayOptions | ||
oldStreamName : String
O nome do antigo fluxo ou do fluxo de transição. | NetStreamPlayOptions | ||
start : Number
O horário de início, em segundos, de streamName. | NetStreamPlayOptions | ||
streamName : String
O nome do novo fluxo para transição ou reprodução. | NetStreamPlayOptions | ||
transition : String
O modo de reprodução ou de transição do streamName. | NetStreamPlayOptions |
Método | Definido por | ||
---|---|---|---|
Cria um objeto NetStreamPlayOptions para especificar as opções transmitidas ao método NetStream.play2(). | NetStreamPlayOptions | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra um objeto de ouvinte de evento em um objeto EventDispatcher, de forma que o ouvinte receba a notificação de um evento. | EventDispatcher | ||
Envia um evento para o fluxo de eventos. | EventDispatcher | ||
Verifica se o objeto EventDispatcher tem ouvintes registrados para um tipo específico de evento. | EventDispatcher | ||
Indica se um objeto tem uma propriedade especificada definida. | Object | ||
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | ||
Indica se a propriedade especificada existe e é enumerável. | Object | ||
Remove um ouvinte do objeto EventDispatcher. | EventDispatcher | ||
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | ||
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | ||
Retorna a representação de string do objeto especificado. | Object | ||
Retorna o valor primitivo do objeto especificado. | Object | ||
Verifica se um ouvinte de evento está registrado nesse objeto EventDispatcher ou em qualquer um de seus ancestrais para o tipo de evento especificado. | EventDispatcher |
len | propriedade |
public var len:Number
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
A duração da reprodução, em segundos, do fluxo especificado em streamName
. O valor padrão é -1, significando que o Flash Player reproduz um fluxo ao vivo, até ele não estar mais disponível, ou reproduz um fluxo gravado até o fim. Se você transmitir 0 para len
, o Flash Player reproduzirá o quadro único que está a start
segundos do início de um fluxo gravado (pressupondo-se que start
seja igual ou maior que 0).
Se você transmitir um número positivo para len
, o Flash Player reproduzirá um fluxo ao vivo por len
segundos, depois que ele estiver disponível, ou reproduzirá um fluxo gravado por len
segundos. (Se um fluxo terminar antes de len
segundos, a reprodução terminará quando o fluxo acabar.)
Se você transmitir um número negativo diferente de -1 para len
, o Flash Player interpretará o valor como se fosse -1.
Elementos da API relacionados
offset | propriedade |
public var offset:Number
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
O tempo de fluxo absoluto em que o servidor alterna entre fluxos de diferentes taxas de bits do fluxo dinâmico do Flash Media Server. A propriedade offset
é usada quando é feita uma chamada a NetStream.play2()
com o modo de transição NetStreamPlayTransitions.SWITCH
. Há dois modos de alternância: alternância rápida e alternância padrão. O valor padrão de offset
é -1
, que é o modo de alterância rápida. Grave a lógica de ActionScript para decidir quando usar a alternância rápida e quando usar a padrão.
Alternância rápida
No modo de alternância rápida, o Flash Media Server alterna para o novo fluxo sem esperar para reproduzir os dados no buffer. Qualquer dado armazenado no buffer no fluxo antigo além de offset
é descartado. A alternância rápida é mais rápida do que a alternância padrão, porque os dados do buffer do fluxo antigo não precisam ser reproduzidos.
O valor padrão de offset
é -1, que é o modo de alternância rápida. Quando offset
é -1, a alternância ocorre no primeiro quadro-chave disponível depois de netstream.time + 3
, que é aproximadamente 3 segundos depois do ponto de reprodução. Você também pode definir a propriedade offset
com qualquer valor maior que netstream.time
. Por exemplo, para fazer a alternância rápida 5 segundos depois do ponto de reprodução, defina a propriedade offset
como netstream.time + 5
. Se o valor de offset
for inferior ao de netstream.time
, um evento de status NetStream.Play.Failed
é despachado.
Observação: a propriedade offset
é o tempo de fluxo absoluto, não se tratando de um deslocamento com relação ao ponto de reprodução. Por exemplo, para alternar 5 segundos do ponto de reprodução, defina a propriedade offset
como netstream.time + 5
, e não como 5
.
Alternância padrão
Para usar a alternância padrão em vez da alternância rápida, defina offset
com um valor maior que netstream.time + netstream.bufferLength
.
Use a alternância padrão quando o cliente tiver uma alta taxa de bits no buffer e quiser alternar para uma largura de banda mais baixa devido à queda de largura de banda (e não devido a questões de CPU ou quadros abandonados). O cliente pode querer reproduzir com a taxa de bits mais alta por tanto tempo quanto possível e alternar para a taxa de bits mais baixa no final do buffer (como na alternância padrão).
Para obter mais informações, consulte "Fast switching between streams" no Adobe Flash Media Server Developer's Guide.
Elementos da API relacionados
oldStreamName | propriedade |
public var oldStreamName:String
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
O nome do antigo fluxo ou do fluxo de transição. Quando NetStream.play2()
for usado para simplesmente reproduzir um fluxo (não executar uma transição), o valor dessa propriedade deverá ser nulo ou indefinido. Caso contrário, especifique o fluxo de transição.
Elementos da API relacionados
start | propriedade |
public var start:Number
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
O horário de início, em segundos, de streamName
. Os valores válidos são -2, -1 e 0.
O valor padrão de start
é -2, significando que o Flash Player primeiro tentará reproduzir o fluxo ao vivo especificado em streamName
. Se não for encontrado um fluxo ao vivo com esse nome, o Flash Player reproduzirá o fluxo gravado especificado em streamName
. Se não for encontrado nenhum fluxo ao vivo nem gravado, o Flash Player abrirá um fluxo ao vivo chamado streamName
, mesmo que ninguém esteja publicando nele. Quando alguém começa a publicar nesse fluxo, o Flash Player começa a reproduzi-lo.
Se você transmitir -1 para start
, o Flash Player reproduzirá somente o fluxo ao vivo especificado em streamName
. Se não for encontrado nenhum fluxo ao vivo, o Flash Player o aguardará indefinidamente, se len
for definido como -1; se len
for definido com outro valor, o Flash Player aguardará len
segundos antes de começar a reproduzir o item seguinte da lista de reprodução.
Se você transmitir 0 ou um número positivo para start
, o Flash Player reproduzirá somente um fluxo gravado chamado streamName
, começando start
segundos a partir do início do fluxo. Se não for encontrado nenhum fluxo gravado, o Flash Player iniciará imediatamente a reprodução do item seguinte da lista de reprodução.
Se você transmitir um número negativo diferente de -1 ou -2 para start
, o Flash Player interpretará o valor como se fosse -2.
Elementos da API relacionados
streamName | propriedade |
public var streamName:String
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
O nome do novo fluxo para transição ou reprodução. Quando oldStreamName
for nulo ou indefinido, a chamada de NetStream.play2()
simplesmente iniciará a reprodução de streamName
. Se oldStreamName
for especificado, a chamada de NetStream.play2()
fará a transição de oldStreamName
para streamName
usando o modo de transição especificado na propriedade transition
.
Elementos da API relacionados
transition | propriedade |
public var transition:String
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
O modo de reprodução ou de transição do streamName
. Os possíveis valores são constantes da classe NetStreamPlayTransitions. Dependendo de o Netstream.play2()
ser chamado ou não para reprodução ou transição de um fluxo, o modo de transição resulta em comportamentos diferentes. Para obter mais informações sobre os modos de transição, consulte a classe NetStreamPlayTransitions.
Elementos da API relacionados
NetStreamPlayOptions | () | Construtor |
public function NetStreamPlayOptions()
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Cria um objeto NetStreamPlayOptions para especificar as opções transmitidas ao método NetStream.play2()
.
Elementos da API relacionados
Wed Jun 13 2018, 11:10 AM Z