:Uso do Push SDK para Windows

Configurar parâmetros de ingestão de fluxo

Use a classe AlivcLivePushConfig para definir os parâmetros de ingestão de fluxo. Cada parâmetro possui um valor padrão. Para uma ingestão básica, mantenha os valores originais.

AlivcLivePushConfig config;

Ingerir um fluxo (da câmera)

A classe AlivcLivePusher é o componente central do Push SDK para Windows. Ela fornece parâmetros para inicialização, callbacks de ingestão, pré-visualização da câmera e gerenciamento do fluxo. Use esta classe também para modificar parâmetros durante a ingestão.

1. Inicialize a classe AlivcLivePusher.

   Após configurar os parâmetros de ingestão, chame o método init para inicializar a classe. Código de exemplo:

   AlivcLivePushConfig config;
   pusher->init(config);

2. Registre os callbacks de ingestão.

   O SDK suporta os seguintes callbacks de ingestão:

   • Info: callbacks para notificações e detecção de status.

   • Error: callbacks acionados quando ocorrem erros.

   • Network: callbacks relacionados à rede.

   Quando um evento ocorre, o sistema dispara o callback correspondente para notificá-lo. Código de exemplo:

   pusher->setLivePushErrorListener(errorListener);
   pusher->setLivePushInfoListener(errorListener);
   pusher->setLivePushNetworkListener(errorListener);

3. Inicie a pré-visualização.

   Inicie a pré-visualização após inicializar o objeto livePusher e configurar os callbacks. Código de exemplo:

   pusher->startPreview(view, width, height);

4. Inicie a ingestão do fluxo.

   pusher->startPush(url);

pusher->stopPush();

Ingerir um fluxo (de uma tela compartilhada)

Transmita a gravação de uma tela, originada de uma shared screen. Para isso, obtenha a lista de fontes de compartilhamento e especifique a fonte desejada para a ingestão. Etapas específicas:

1. Obtenha a lista de fontes de compartilhamento.

   pusher->getScreenShareSourceInfo();

2. Inicie a ingestão de uma fonte compartilhada.

   pusher->startScreenShareByDesktopId(desktopId);

   Nota

   • desktopId representa o ID da área de trabalho. Consulte esse ID chamando o método GetScreenShareSourceInfo.

Configurar o controle de taxa de bits

Use o método abaixo para configurar o controle de taxa de bits:

1. Defina o parâmetro de inicialização enableBitrateControl para ativar o controle de taxa de bits.

   config.enableBitrateControl = true;

   Nota

   Ao ativar este recurso, o sistema ajusta automaticamente a taxa de bits entre a taxa alvo e a taxa mínima especificadas. Se você desativar essa opção, a taxa permanecerá fixa no valor inicial, o que pode causar travamentos em redes instáveis. Tenha cautela antes de desabilitar essa funcionalidade. Recomendamos mantê-la ativa.

2. Especifique parâmetros personalizados de taxa de bits.

   Os parâmetros incluem mInitialVideoBitrate, mMinVideoBitrate e mTargetVideoBitrate, que correspondem, respectivamente, à taxa de bits inicial, mínima e alvo.

   config.mTargetVideoBitrate = 1400; // Set the target bitrate to 1,400 Kbit/s.
   config.mMinVideoBitrate = 600; // Set the minimum bitrate to 600 Kbit/s.
   config.mInitialVideoBitrate = 1000; // Set the initial bitrate to 1,000 Kbit/s.

   A tabela a seguir apresenta os valores recomendados para esses parâmetros:

   Resolução	mInitialVideoBitrate	mMinVideoBitrate	mTargetVideoBitrate
   360p	600	300	1000
   480p	800	300	1200
   540p	1000	600	1400
   720p	1500	600	2000
   1080p	1800	1200	2500

   Resolução	mInitialVideoBitrate	mMinVideoBitrate	mTargetVideoBitrate
   360p	400	200	600
   480p	600	300	800
   540p	800	300	1000
   720p	1000	300	1200
   1080p	1500	1200	2200

   Nota

   Se você não configurar os parâmetros mInitialVideoBitrate, mMinVideoBitrate e mTargetVideoBitrate, o Push SDK definirá automaticamente uma taxa de bits adequada para a câmera com base na resolução.

Ingerir uma imagem

O Push SDK para Windows permite ingerir imagens quando o aplicativo passa para segundo plano ou quando a taxa de bits está baixa, o que melhora a experiência do usuário.

Quando o aplicativo passa para segundo plano, a ingestão de fluxo de vídeo pausa e apenas o áudio continua sendo ingerido. Nesse cenário, especifique uma imagem para ingestão. Por exemplo, exiba uma mensagem como The streamer will be back soon. para avisar os espectadores.

config.mPausePushImagePath = "The path of the specified image in the PNG format for stream ingest";// Specify the image for stream ingest when your app is switched to the background.

Escutar callbacks

O Push SDK possibilita o recebimento de callbacks para exceções e erros de ingestão, o que permite tratar adequadamente essas situações. O Push SDK para Windows oferece os seguintes tipos de callbacks.

Lista de classes comuns