Inscreva-se: Diagnósticos

Para obter estatísticas de áudio e vídeo dos assinantes, adicione manipuladores de eventos para o audioNetworkStats e videoNetworkStats evento disparado pelo OTSubscriber. Esses eventos fornecem informações sobre o fluxo do assinante, incluindo o seguinte:

• O número total de pacotes de áudio e vídeo perdidos.
• O número total de pacotes de áudio e vídeo recebidos.
• O número total de bytes de áudio e vídeo recebidos.
• A taxa média atual de quadros do vídeo.

<OTSubscriber
  eventHandlers={{
    audioNetworkStats: event => {
      console.log('subscriber audioNetworkStats event', event);
    },
    videoNetworkStats: event => {
      console.log('subscriber videoNetworkStats event', event);
    },
  }}
/>

Para obter estatísticas mais detalhadas sobre a transmissão, use o Subscriber.getRtcStatsReport() método do objeto OTSubscriber. Ele retorna uma promessa que, em caso de sucesso, é resolvida com uma representação em JSON de um RtcStatsReport objeto para o fluxo assinado:

<OTSubscriber
  eventHandlers={{
    connected: event => {
      setTimeout(() => {
        this.subscriber.getRtcStatsReport();
      }, 4000);
    },
    rtcStatsReport: event => {
      console.log('subscriber rtcStatsReport event', event);
    },
  }}
/>

O objeto Stream possui as seguintes propriedades que definem o fluxo:

• connection — O objeto Connection correspondente à conexão que está publicando o fluxo. Você pode comparar isso com a propriedade connection do objeto Session para verificar se o fluxo está sendo publicado pela página da web local.
• creationTime — O carimbo de data/hora (um número) correspondente à criação do fluxo. Esse valor é calculado em milissegundos. É possível converter esse valor em um objeto Date chamando new Date(stream.creationTime).
• hasAudio — (Booleano) Indica se o stream possui áudio. Essa propriedade pode mudar se o editor ativar ou desativar o áudio (chamando Publisher.publishAudio()). Quando isso ocorre, o Sessão o objeto despacha um streamPropertyChanged evento.
• hasVideo — (Booleano) Se a transmissão contém vídeo. iniciais—(Booleano) As iniciais da transmissão (caso tenham sido definidas quando o editor da transmissão foi inicializado).
• name — (String) O nome do fluxo. Por padrão, ele é exibido quando o usuário passa o mouse sobre o Assinante no DOM HTML. No entanto, é possível personalizar a interface do usuário para ocultar o nome ou exibi-lo sem precisar passar o mouse sobre ele.
• videoDimensions — Este objeto possui duas propriedades: width e height. Ambos são números. O width A propriedade é a largura do fluxo codificado; o height Essa propriedade representa a altura do fluxo codificado. (Esses valores são independentes da largura real dos objetos Publisher e Subscriber correspondentes ao fluxo.) Essa propriedade pode mudar se um fluxo publicado a partir de um dispositivo iOS for redimensionado, devido a uma mudança na orientação do dispositivo.
• videoType — O tipo de vídeo: “câmera”, “tela”, “personalizado” ou indefinido. Um vídeo do tipo “tela” utiliza o compartilhamento de tela no editor como fonte de vídeo; um vídeo do tipo “personalizado” utiliza um elemento VideoTrack como fonte de vídeo no editor. O videoType é undefined quando uma transmissão é apenas de voz (consulte o Guia apenas por voz). Essa propriedade pode mudar se uma transmissão publicada a partir de um dispositivo móvel passar de um tipo de vídeo capturado pela câmera para um tipo de vídeo de compartilhamento de tela. Para obter mais informações, consulte Compartilhamento de tela — Web.

O hasAudio, hasVideo, videoDimensions, e videoType as propriedades podem sofrer alterações (por exemplo, quando o editor ativa ou desativa o vídeo). Quando isso ocorre, o objeto Session dispara um evento streamPropertyChanged (consulte StreamPropertyChangedEvent).

O objeto Stream possui os seguintes métodos que retornam valores que definem o fluxo:

• getConnection()— (Connection) Retorna o objeto Connection correspondente à conexão que está publicando o fluxo. É possível comparar esse valor com o valor retornado pela getConnection() método do objeto Session para verificar se o fluxo está sendo publicado pelo seu cliente.
• getCreationTime()— (Data) O carimbo de data e hora correspondente ao momento da criação do fluxo.
• hasAudio()— (booleano) Se o stream possui áudio.
• hasVideo()— (booleano) Se o stream contém vídeo.
• getName()— (String) Retorna o nome do fluxo. Esse nome é definido ao inicializar o Publisher do fluxo (consulte Inicializando um objeto Publisher).
• getStreamId()— (String) O ID exclusivo do stream.
• getVideoHeight()— (int) A altura do fluxo, em pixels.
• getVideoType()— (StreamVideoType) Se a transmissão utiliza uma fonte de vídeo de câmera (StreamVideoTypeCamera.StreamVideoTypeCamera), uma fonte de vídeo para compartilhamento de tela (StreamVideoTypeScreen.StreamVideoTypeScreen), ou uma fonte de vídeo personalizada (StreamVideoTypeScreen.StreamVideoTypeScreen).

Veja Compartilhamento de tela.

• getVideoWidth()— (int) A largura do fluxo, em pixels.

O objeto OTStream possui as seguintes propriedades que definem o fluxo:

• connection—O objeto OTConnection correspondente à conexão que está publicando o fluxo. Você pode comparar isso com o connection propriedade do objeto OTSession para verificar se o fluxo está sendo publicado pelo seu cliente.
• creationTime—O carimbo de data e hora correspondente à data de criação do stream.
• hasAudio—(Bool) Se o stream possui áudio.
• hasVideo—(Bool) Se a transmissão contém vídeo.
• name—(String?) O nome do fluxo. Esse valor é definido ao inicializar o Publisher do fluxo (consulte Inicializando um objeto OTPublisher).
• session—(OTSession) A sessão de vídeo da Vonage à qual o fluxo está vinculado.
• streamId—(String) O ID exclusivo do fluxo.
• videoDimensions—Um objeto CGSize que define as dimensões atuais da trilha de mídia de vídeo neste fluxo.
• videoType—(OTStreamVideoType) Se a transmissão utiliza uma fonte de vídeo de câmera (OTStreamVideoTypeCamera), uma fonte de vídeo para compartilhamento de tela (OTStreamVideoTypeScreen), ou uma fonte de vídeo personalizada (OTStreamVideoTypeCustom).

Veja Compartilhamento de tela.

O objeto OTStream possui as seguintes propriedades que definem o fluxo:

• connection—O objeto OTConnection correspondente à conexão que está publicando o fluxo. Você pode comparar isso com o connection propriedade do objeto OTSession para verificar se o fluxo está sendo publicado pelo seu cliente.
• creationTime—O carimbo de data e hora NSDate correspondente à data de criação do fluxo.
• hasAudio—(Booleano) Se o stream possui áudio.
• hasVideo—(Booleano) Se a transmissão contém vídeo.
• name—(NSString) O nome do fluxo. Esse valor é definido ao inicializar o Publisher do fluxo (consulte Inicializando um objeto OTPublisher).
• session—(OTSession) A sessão de vídeo da Vonage à qual o fluxo está vinculado.
• streamId—(NSString) O ID exclusivo do fluxo.
• videoDimensions—Um objeto CGSize que define as dimensões atuais da trilha de mídia de vídeo neste fluxo.
• videoType—(OTStreamVideoType) Se a transmissão utiliza uma fonte de vídeo de câmera (OTStreamVideoTypeCamera), uma fonte de vídeo para compartilhamento de tela (OTStreamVideoTypeScreen), ou uma fonte de vídeo personalizada (OTStreamVideoTypeCustom).

Veja Compartilhamento de tela.

O objeto Stream possui as seguintes propriedades que definem o fluxo:

• Connection— (Conexão) O objeto Connection correspondente à conexão que está publicando o fluxo. Você pode comparar isso com o Connection propriedade do objeto Session para verificar se o fluxo está sendo publicado pelo seu cliente.
• CreationTime— (DateTime) O carimbo de data e hora (DateTime) correspondente ao momento da criação do fluxo.
• HasAudio— (bool) Se o stream possui áudio.
• HasVideo— (bool) Indica se a transmissão contém vídeo.
• Name— (string) O nome do fluxo. Esse valor é definido ao inicializar o Publisher do fluxo (consulte Inicializando um objeto Publisher).
• Id— (string) O ID exclusivo do stream.
• Height— (int) A altura do fluxo, em pixels.
• VideoSourceType— (VideoSourceType) Se a transmissão utiliza uma fonte de vídeo de câmera (VideoSourceType.StreamVideoTypeCamera), uma fonte de vídeo para compartilhamento de tela (VideoSourceType.StreamVideoTypeScreen), ou uma fonte de vídeo personalizada (VideoSourceType.StreamVideoTypeCustom).

Veja Compartilhamento de tela.

• Width— (int) A largura do fluxo, em pixels.

Chame as seguintes funções para obter informações sobre um fluxo:

• otc_stream_get_connection()— Retorna o otc_connection instância correspondente à conexão que está publicando o fluxo. Você pode comparar o ID dessa conexão com o ID da conexão para o otc_connection instância retornada pelo otc_session_get_connection() função para verificar se o stream está sendo publicado pelo seu cliente.
• otc_stream_get_creation_time()— Retorna o timestamp correspondente à hora de criação do stream.
• otc_stream_has_audio()— Se a transmissão está transmitindo áudio no momento.
• otc_stream_has_video()— Se a transmissão está exibindo vídeo no momento.
• otc_stream_has_audio_track()— Se a transmissão possui uma trilha de áudio.
• otc_stream_has_video_track()— Se a transmissão possui uma trilha de vídeo.
• otc_stream_get_name()— Retorna o nome do fluxo. Esse nome é definido quando você inicializa o Publisher do fluxo (consulte Inicializando uma estrutura `otc_publisher` e definindo callbacks do publisher).
• otc_stream_get_id()— Retorna o ID exclusivo do stream.
• otc_stream_get_video_height()— A altura do fluxo, em pixels.
• otc_stream_get_video_type()— Se a transmissão utiliza uma fonte de vídeo de câmera (OTC_STREAM_VIDEO_TYPE_CAMERA) ou uma fonte de vídeo de compartilhamento de tela (OTC_STREAM_VIDEO_TYPE_SCREEN).
• otc_stream_get_video_width()— A largura do stream, em pixels.

Quando o vídeo de um assinante é desativado, o objeto OTSubscriber dispara um videoDisabled evento:

<OTSubscriber
  eventHandlers={{
    videoDisabled: (event) => {
      console.log('stream video disabled -- stream ID:', event.streamId);
      // Display a user interface notification.
    },
  }}/>

Quando o Media Router desativa o vídeo de um assinante, talvez seja necessário ajustar a interface do usuário relacionada a esse assinante.

O reason propriedade do videoDisabled O objeto de evento define o motivo pelo qual o vídeo foi desativado. Ele pode ser definido com um dos seguintes valores:

• "PublisherPropertyChanged" — A editora deixou de publicar vídeos.

• "QualityChanged" — O Media Router interrompeu o envio de vídeo ao assinante devido a alterações na qualidade do stream. Esse recurso do Media Router faz com que o assinante interrompa o stream de vídeo quando a conectividade se deteriora. (O assinante continua recebendo o stream de áudio, caso haja um.)

Antes de enviar esse evento, quando a qualidade do stream do assinante se deteriora a um nível tão baixo que o stream de vídeo corre o risco de ser desativado, o OTSubscriber o objeto envia um videoDisableWarning evento.

Se a conectividade melhorar a ponto de permitir novamente a exibição de vídeos, o OTSubscriber o objeto despacha um videoEnabled evento, e o assinante volta a receber o vídeo.

Esse recurso está disponível apenas em sessões que utilizam o Roteador de mídia (sessões com o modo de mídia definido como “roteado”), e não em sessões com o modo de mídia definido como “retransmitido”.

Ao publicar uma transmissão, você pode evitar que o vídeo seja desativado devido à qualidade da transmissão. Defina audioFallbackEnabled para false no properties passar o prop para o componente OTPublisher.

• "SubscriberPropertyChanged" — O assinante iniciou ou interrompeu a assinatura do vídeo, definindo `subscribeToVideo` como `false` na propriedade `prop` passada para o OTSubscriber componente.

• "CodecNotSupported" — O assinante interrompeu a assinatura do vídeo devido a um codec incompatível (consulte o Guia para desenvolvedores de codecs de vídeo).

O OTSubscriber despachos de objetos videoEnabled evento quando o vídeo for retomado:

A propriedade `reason` do objeto do evento `videoEnabled` define o motivo pelo qual o vídeo foi ativado. Ela pode ser definida com um dos seguintes valores:

• "PublisherPropertyChanged" — A editora retomou a publicação de vídeos.

• "QualityChanged" — O Media Router retomou o envio do vídeo ao assinante com base nas mudanças na qualidade do stream. Esse recurso do Media Router faz com que o assinante interrompa o stream de vídeo quando a conectividade piora e, em seguida, retome o stream caso a qualidade melhore.

Esse recurso está disponível apenas em sessões que utilizam o Media Router (sessões com o modo de mídia definido como “routed”), e não em sessões com o modo de mídia definido como “relayed”.

• "SubscriberPropertyChanged" — O assinante iniciou ou cancelou a assinatura do vídeo, ao definir subscribeToVideo para “false” na propriedade prop passada ao componente OTSubscriber.

• "CodecNotSupported" — O vídeo para assinantes foi habilitado após uma mudança de codec, que antes era incompatível (consulte o Guia para desenvolvedores de codecs de vídeo).

Quando um stream, que não seja o seu, sai de uma sessão, o objeto Session dispara um streamDestroyed evento:

session.on("streamDestroyed", function (event) {
  console.log("Stream stopped. Reason: " + event.reason);
});

Quando um fluxo publicado sai de uma sessão, o objeto Publisher dispara um streamDestroyed evento:

var publisher = OT.initPublisher();
publisher.on("streamDestroyed", function (event) {
  console.log("Stream stopped. Reason: " + event.reason);
});

O streamDestroyed O evento é definido pela classe StreamEvent. O evento inclui um reason propriedade, que explica por que a transmissão foi encerrada. Esses motivos incluem "clientDisconnected", "forceDisconnected", "forceUnpublished", ou "networkDisconnected". Para mais detalhes, consulte StreamEvent.

Por padrão, quando um streamDestroyed Quando um evento é disparado para um fluxo ao qual você está inscrito, os objetos Subscriber correspondentes (pode haver mais de um) são destruídos e removidos do DOM HTML. Você pode impedir esse comportamento padrão chamando o preventDefault() método do objeto StreamEvent:

session.on("streamDestroyed", function (event) {
  event.preventDefault();
  var subscribers = session.getSubscribersForStream(event.stream);
  // Now you can adjust the DOM elements around each
  // subscriber to the stream, and then delete it yourself.
});

Observe que o getSubscribersForStream() O método de um objeto Session retorna todos os objetos Subscriber de um Stream.

Talvez você queira impedir o comportamento padrão e manter o Subscriber, caso deseje ajustar os elementos DOM relacionados antes de excluir o Subscriber por conta própria. Em seguida, você pode excluir o objeto Subscriber (e seu elemento DOM) chamando o destroy() método do objeto Subscriber.

Um objeto Subscriber despacha um destroyed evento que ocorre quando o objeto é removido do DOM HTML. Em resposta a esse evento, você pode optar por ajustar (ou remover) os elementos do DOM relacionados ao assinante que foi removido.

Quando os fluxos publicados por outros clientes saem de uma sessão, o onStreamDropped(Session session, Stream stream) é chamado o método do objeto Session.SessionListener. Quando um fluxo é encerrado, a visualização de qualquer objeto Subscriber associado a esse fluxo é removida de sua supervisualização.

Detectar quando o vídeo de um assinante está desativado

O Vonage Video Media Router interrompe o envio de vídeo ao assinante quando detecta que a conectividade está se deteriorando. O assinante continua recebendo o fluxo de áudio, caso haja algum. O onVideoDisabled(assinante, assinante) O método do objeto SubscriberKit.VideoListener é chamado quando o Vonage Video Media Router interrompe o envio de vídeo:

@Override
public void onVideoDisabled(subscriber, reason) {
    // Video is disabled for the subscriber
}

O reason O parâmetro identifica o motivo pelo qual o assinante interrompeu a transmissão do vídeo.

Quando o Vonage Video Media Router desativa o vídeo de um assinante, talvez seja necessário ajustar a interface do usuário relacionada a esse assinante.

O onVideoEnabled(assinante, motivo) O método do objeto SubscriberKit.VideoListener é chamado quando o vídeo retoma a reprodução:

@Override
public void onVideoEnabled(subscriber, reason) {
// Video is resumes for the subscriber
}

O reason O parâmetro identifica o motivo pelo qual o vídeo do assinante foi retomado.

Ao publicar uma transmissão, você pode evitar que o vídeo seja desativado devido à qualidade da transmissão. Antes de chamar a função Session.publish(publisher) método, chame o setAudioFallbackEnabled(boolean enabled) método do objeto Publisher (ou do objeto PublisherKit) e passar false.

Quando os streams saem de uma sessão, o OTSession session(_:streamDestroyed:) A mensagem é enviada. Quando um stream é descartado, a visualização de qualquer objeto OTSubscriber associado a esse stream é removida de sua superview. Verifique se o stream não foi publicado pelo seu próprio cliente e remova sua visualização da superview.

func session(_ session: OTSession, streamDestroyed stream: OTStream) {
    print("Session streamDestroyed: \(stream.streamId)")

    if subscriber?.stream?.streamId == stream.streamId {
        subscriber?.view?.removeFromSuperview()
        subscriber = nil
    }
}

Detectar quando o vídeo de um assinante está desativado

O representante do assinante envia o OTSubscriberDelegate subscriberVideoDisabled(_:reason:) mensagem exibida quando o vídeo do assinante está desativado:

func subscriberVideoDisabled(_ subscriber: OTSubscriberKit, reason: OTSubscriberVideoEventReason) {
    print("subscriber video disabled.")
}

O reason O parâmetro pode ser definido como uma das seguintes constantes definidas na enumeração OTSubscriberVideoEventReason:

• OTSubscriberVideoEventPublisherPropertyChanged — O problema com o vídeo ocorreu porque o autor da transmissão interrompeu a transmissão.
• OTSubscriberVideoEventQualityChanged — O problema no vídeo foi causado por uma alteração na qualidade do fluxo de vídeo. A qualidade do fluxo pode variar devido às condições da rede ou ao uso da CPU, tanto no lado do assinante quanto no do emissor. Esse motivo é utilizado apenas em sessões cujo modo de mídia esteja definido como “roteado”. (Consulte O Roteador de Mídia de Vídeo da Vonage e os modos de mídia.) Esse recurso do Vonage Video Media Router faz com que o assinante interrompa a transmissão de vídeo quando a qualidade do sinal se deteriora, e a mensagem é enviada. Quando as condições melhoram, a transmissão de vídeo é retomada, e o OTSubscriberDelegate subscriberVideoEnabled(_:reason:) A mensagem é enviada. Quando o fluxo de vídeo é interrompido, o assinante continua recebendo o fluxo de áudio, caso haja um.
• OTSubscriberVideoEventSubscriberPropertyChanged — O problema com o vídeo foi causado por uma alteração na conta deste assinante OTSubscriber subscribeToVideo propriedade.

Se a transmissão de vídeo for retomada, o OTSubscriberDelegate subscriberVideoEnabled(_:reason:) A mensagem é enviada.

Ao publicar uma transmissão, você pode evitar que o vídeo seja desativado devido à qualidade da transmissão. Antes de chamar a função OTSession publish(_:error:) método, defina o audioFallbackEnabled propriedade do objeto Publisher (ou do objeto PublisherKit) para “false”.

O [OTSessionDelegate session:streamCreated:] A mensagem é enviada quando um novo fluxo é criado em uma sessão. (Um fluxo é criado quando um cliente publica um fluxo para a sessão.) O Objeto OTStream possui propriedades que definem o fluxo. Compare o connection propriedade do objeto OTStream com o connection propriedade do objeto OTSession para determinar se o fluxo é aquele publicado pelo seu cliente:

- (void)session:(OTSession*)session streamCreated:(OTStream*)stream
{
    NSLog(@"session streamCreated (%@)", stream.streamId);

    // See the declaration of subscribeToSelf above.
    if ([stream.connection.connectionId isEqualToString: session.connection.connectionId]) {
        // This is my own stream
    } else {
        // This is a stream from another client.
    }
}

Quando os fluxos publicados por outros clientes saem de uma sessão, o objeto Session envia um StreamDropped evento:

session.StreamDropped += Session_StreamDropped;

public void Session_StreamDropped(object sender, EventArgs e)
{
  // Stream dropped
}

O objeto de argumentos de evento passado para esta função é definido pela classe OpenTok.Session.StreamEventArgs. Essa classe inclui um Stream propriedade. Compare isso Stream opor-se à Stream propriedade de cada objeto Subscriber para identificar o assinante da transmissão.

Detectar quando o vídeo de um assinante está desativado

O Vonage Video Media Router interrompe o envio de vídeo ao assinante quando detecta que a conectividade está se deteriorando. O assinante continua recebendo o fluxo de áudio, caso haja algum. Quando o Vonage Video Media Router interrompe o envio de vídeo, o objeto Assinante envia um VideoDisabled evento:

subscriber.VideoDisabled += Subscriber_VideoDisabled;

public void Subscriber_VideoDisabled(object sender)
{
  // Display a user interface notification.
}

Quando o Vonage Video Media Router desativa o vídeo de um assinante, talvez seja necessário ajustar a interface do usuário relacionada a esse assinante.

O objeto Subscriber envia um VideoDisabled evento quando o vídeo for retomado:

subscriber.VideoEnabled += Subscriber_VideoEnabled;

public void Subscriber_VideoEnabled(object sender)
{
  // Video resumes for the subscriber.
}

O on_stream_dropped função de retorno de chamada do otc_session_callbacks A função `struct` é chamada quando o stream de outro cliente é removido da sessão do Vonage Video. O stream O parâmetro passado para esta função é um ponteiro para um otc_stream estrutura para o fluxo. Chame a otc_stream_get_id() método, passando o otc_stream struct, para obter o ID do fluxo.

Detectar quando o vídeo de uma transmissão está desativado

O on_stream_has_video_changed função de retorno de chamada do otc_session_callbacks A função `struct` é chamada quando o stream de outro cliente é removido da sessão do Vonage Video. O stream O parâmetro passado para esta função é um ponteiro para um otc_stream estrutura para o fluxo. Chame a otc_stream_get_id() método, passando o otc_stream struct, para obter o ID do fluxo.