ApsaraVideo Live:Utiliser le SDK Push pour Flutter

/// Create an AlivcLivePusher instance.
AlivcLivePusher livePusher = AlivcLivePusher.init();

/// Create a Config object to associate AlivcLivePushConfig with AlivcLivePusher.
livePusher.createConfig();

/// Create an AlivcLivePushConfig instance.
AlivcLivePushConfig pusherConfig = AlivcLivePushConfig.init();

/// Configure stream ingest parameters.
/// Set the resolution to 540P.
pusherConfig.setResolution(AlivcLivePushResolution.resolution_540P);
/// Specify the frame rate. We recommend that you set it to 20 frames per second (FPS).
pusherConfig.setFps(AlivcLivePushFPS.fps_20);
/// Specify whether to enable adaptive bitrate streaming. The default value is true.
pusherConfig.setEnableAutoBitrate(true);
/// Specify the group of pictures (GOP) size. A larger value indicates a higher latency. We recommend that you set it to a number from 1 to 2.
pusherConfig.setVideoEncodeGop(AlivcLivePushVideoEncodeGOP.gop_2);
/// Specify the reconnection duration. The value cannot be less than 1000. Unit: milliseconds. We recommend that you use the default value.
pusherConfig.setConnectRetryInterval(2000);
/// Disable the mirroring mode for preview.
pusherConfig.setPreviewMirror(false);
/// Set the stream orientation to portrait.
pusherConfig.setOrientation(AlivcLivePushOrientation.portrait);

Méthodes liées à l'ingestion

/// Pause stream ingest from the camera. You can call setPauseImg to configure the image displayed during the pause. Then, call the pause method to switch from camera feeds to the specified image. The audio stream continues to be ingested.
livePusher.pause();
/// Resume stream ingest to switch from image to camera feeds. The audio stream continues to be ingested.
livePusher.resume();
/// Stop a stream that is being ingested.
livePusher.stopPush();
/// Stop preview. However, this operation does not take effect for a stream that is being ingested. When preview is stopped, the preview window is frozen at the last frame.
livePusher.stopPreview();
/* Restart stream ingest when the stream is being ingested or when an error callback is received. All resources in AlivcLivePusher are reinitialized, including preview and ingestion. If an error occurs, you can call this method or the reconnectPushAsync method to restart stream ingest. You can also call the destroy method to destroy the stream ingest instance. */
livePusher.restartPush();
/* Reconnect and repush the RTMP stream during streaming or network error state (setNetworkDelegate). In the error state, you can also call destroy to dispose the instance.*/
livePusher.reconnectPushAsync();
/// Stop stream ingest and preview. After you call this method, all resources related to AlivcLivePusher are disposed.
livePusher.destory();

/// Switch between the front and rear cameras.
livePusher.switchCamera();
/// Enable or disable flash. You cannot enable flash for the front camera.
livePusher.setFlash(false);

/// Adjust the focal length to zoom in or out. If you set the input parameter to a positive number, the system increases the focal length. If you set the input parameter to a negative number, the system decreases the focal length.
double max = await livePusher.getMaxZoom();
livePusher.setZoom(min(1.0, max));

/// Configure manual focus.
/// The autoFocus parameter specifies whether to enable autofocus. This parameter takes effect only for this call. Whether autofocus is enabled depends on the setAutoFocus method.
double pointX = 50.0; // The custom value
double pointY = 50.0; // The custom value
bool autoFocus = true;
livePusher.focusCameraAtAdjustedPoint(pointX, pointY, autoFocus);

/// Disable autofocus.
livePusher.setAutoFocus(false);
/// Disable the mirroring mode for preview.
livePusher.setPreviewMirror(false);
/// Disable the mirroring mode for stream ingest.
livePusher.setPushMirror(false);

/// Specify the image that is ingested during the pause.
String pauseImagePath = "xxxx"; // xxxx specifies the path of the image.
pusherConfig.setPauseImg(pauseImagePath);

/// Specify the image that is ingested in poor network conditions.
String networkPoorImagePath = "xxxx"; // xxxx specifies the path of the image.
pusherConfig.setNetworkPoorImg(networkPoorImagePath);

/// Set the preview display mode.
pusherConfig.setPreviewDisplayMode(AlivcPusherPreviewDisplayMode.preview_aspect_fit);

Priorité à la résolution (par défaut)

Le SDK configure automatiquement les paramètres de débit binaire pour privilégier la qualité vidéo.

pusherConfig.setQualityMode(AlivcLivePushQualityMode.resolution_first);

Priorité à la fluidité

Le SDK configure automatiquement les paramètres de débit binaire pour privilégier la fluidité du flux.

pusherConfig.setQualityMode(AlivcLivePushQualityMode.fluency_first);

Mode personnalisé

Le SDK utilise les valeurs initiales, minimales et cibles de débit binaire que vous avez spécifiées.

• TargetVideoBitrate : Dans de bonnes conditions réseau, le débit binaire augmente progressivement jusqu'au débit cible pour améliorer la qualité vidéo.

• MinVideoBitrate : Dans de mauvaises conditions réseau, le débit binaire est réduit progressivement jusqu'au minimum pour éviter les saccades.

• InitialVideoBitrate : Débit binaire initial au démarrage d'un flux en direct.

pusherConfig.setQualityMode(AlivcLivePushQualityMode.custom);
pusherConfig.setInitialVideoBitrate(1000);
pusherConfig.setMinVideoBitrate(600);
pusherConfig.setTargetVideoBitrate(1400);

Reportez-vous aux paramètres de débit binaire recommandés ci-dessous :

• Paramètres recommandés pour le mode Priorité à la résolution

  Résolution	Débit binaire initial	Débit binaire minimal	Débit binaire cible
  360P	600	300	1000
  480P	800	300	1200
  540P	1000	600	1400
  720P	1500	600	2000
  1080P	1800	1200	2500

• Paramètres recommandés pour le mode Priorité à la fluidité

  Résolution	Débit binaire initial	Débit binaire minimal	Débit binaire cible
  360P	400	200	600
  480P	600	300	800
  540P	800	300	1000
  720P	1000	300	1200
  1080P	1500	1200	2200

/// Enable adaptive resolution。
pusherConfig.setEnableAutoResolution(true);

/// Start the playback of background music。
String musicPath = "xxxx"; // xxxx specifies the path in which the music resources are stored.
livePusher.startBGMWithMusicPathAsync(musicPath);
/// Stop the playback of background music. If you want to change the background music, call the method that is used to start the playback of background music. You do not need to stop the playback of the current background music.
livePusher.stopBGMAsync();
/// Pause the playback of background music. You can call this method only after the playback of background music starts.
livePusher.pauseBGM();
/// Resume the playback of background music. You can call this method only after the playback of background music is paused.
livePusher.resumeBGM();
/// Enable looping.
livePusher.setBGMLoop(true);
/// Configure denoising. When enabled, the system filters out non-vocal parts from the collected audio. This feature may slightly reduce the volume of the human voice. We recommend that you allow your users to determine whether to enable this feature. By default, this feature is disabled.
livePusher.setAudioDenoise(true);
/// Configure in-ear monitoring. In-ear monitoring is suitable for karaoke scenarios. When enabled, headphone users can hear their voice. When disabled, they cannot hear their voice on headphones. This parameter does not take effect if no headphones are detected. 
livePusher.setBGMEarsBack(true);
/// Specify the volume of the background music in the mixed audio.
livePusher.setBGMVolume(50); // Valid values: 0 to 100. Default value: 50
/// Specify the volume of the human voice in the mixed audio.
livePusher.setCaptureVolume(50); // Valid values: 0 to 100. Default value: 50
/// Configure muting. If you enable this feature, the background music and human voice are muted. To separately mute the background music or human voice, call the method that is used to configure the volume.
livePusher.setMute(true);

/// Configure the callback for end of playback of background music.
livePusher.setOnBGMCompleted(() {});
/// Configure the callback for timeout of the download of background music.
livePusher.setOnBGMDownloadTimeout(() {});
/// Configure the callback for failed playback of background music.
livePusher.setOnBGMOpenFailed(() {});
/// Configure the callback for paused playback of background music.
livePusher.setOnBGMPaused(() {});
/// Configure the callback for playback progress.
livePusher.setOnBGMProgress((progress, duration) {});
/// Configure the callback for resumed playback of background music.
livePusher.setOnBGMResumed(() {});
/// Configure the callback for start of playback of background music.
livePusher.setOnBGMStarted(() {});
/// Configure the callback for stop of playback of background music.
livePusher.setOnBGMStoped(() {});

/// Capture a snapshot.
String dir = "xxxx"; // xxxx specifies the path in which snapshots are stored.
if (Platform.isIOS) {
    /// dir parameter: On iOS, the path is a relative path. A custom directory is automatically generated in the system sandbox. If you set this parameter to "", snapshots are stored in the root directory of the system sandbox.
    /// dirTypeForIOS parameter: Optional. If you do not specify this parameter, snapshots are stored in the [document] directory of the system sandbox.
    livePusher.snapshot(1, 0, dir, dirTypeForIOS: AlivcLiveSnapshotDirType.document);
} else {
    livePusher.snapshot(1, 0, dir);
}
/// Set the listener for snapshot capture. You can call this method only after you call snapshot.
livePusher.setSnapshotDelegate();

/// Configure callbacks related to snapshot capture.
livePusher.setOnSnapshot((saveResult, savePath, {dirTypeForIOS}) {
  	// The callback that is triggered when a snapshot is stored.
    if (saveResult == true) {
      if (Platform.isIOS) {
        // Construct the full path of snapshots in the system sandbox. Format: dirTypeForIOS + savePath.
      } else {
        // Obtain the path of snapshots based on the value of savePath.
      }
    }
  });

String watermarkBundlePath = "xxxx"; //xxxx specifies the path in which the watermark image is stored.
double coordX = 0.1;
double coordY = 0.1;
double width = 0.3;
/// Add a watermark.
livePusher.addWatermark(watermarkBundlePath, coordX, coordY, width);

/// Enable custom audio and video input.
pusherConfig.setExternMainStream(true);
/// Specify the color format for video data. In this example, YUVNV21 is used. You can also use other formats based on your business requirements.
pusherConfig.setExternVideoFormat(AlivcLivePushVideoFormat.YUVNV21);
/// Specify the bit depth format for audio data. In this example, S16 is used. You can also use other formats based on your business requirements.
pusherConfig.setExternMainStream(AlivcLivePushAudioFormat.S16);

Transmettre des données vidéo externes

/// Only continuous buffer data in the YUV or RGB format can be sent by using the sendVideoData method. You can specify the video buffer, length, width, height, timestamp, and rotation angle.
Uint8List bufferData = xxxx; // xxxx indicates the continuous video buffer data in the Uint8List format.
int width = 720; // The video width.
int height = 1280; // The video height.
int dataSize = xxxx; // xxxx indicates the size of the data.
int pts = xxxx; // xxxx indicates the timestamp in microseconds.
int rotation = 0; // The rotation angle.
livePusher.sendVideoData(bufferData, width, height, size, pts, rotation);

Transmettre des données audio externes

/// Only continuous buffer data in the PCM format can be sent by using the sendPCMData method. You can specify the audio buffer, length, and timestamp.
Uint8List bufferData = xxxx; // xxxx indicates the continuous audio buffer data in the Uint8List format.
int dataSize = xxxx; // xxxx indicates the size of the data.
int sampleRate = xxxx; // xxxx indicates the audio sample rate.
int channel = 0; // The number of sound channels.
int pts = xxxx; // xxxx indicates the timestamp in microseconds.
livePusher.sendPCMData(bufferData, size, sampleRate, channel, pts);

/// Obtain the version number of the native Push SDK.
String sdkVersion = await AlivcLiveBase.getSdkVersion();

/// Enable log printing in the console.
AlivcLiveBase.setConsoleEnable(true);
/// Set the log level to Debug.
AlivcLiveBase.setLogLevel(AlivcLivePushLogLevel.debug);

/// Specify the maximum size of each shard. The total log size is five times the maximum shard size.
const int saveLogMaxPartFileSizeInKB = 100 * 1024 * 1024;
/// Log path.
String saveLogDir = "TODO";
/// Specify the log path and log shard size。
AlivcLiveBase.setLogPath(saveLogDir, saveLogMaxPartFileSizeInKB);

/// Reset the Config object on iOS.
livePusher.destroyConfigForIOS();

/// 1. Initialize the retouching object.
AlivcLiveBeautyManager beautyManager = AlivcLiveBeautyManager.init();
beautyManager.setupBeauty();
/// 2. Show the retouching panel.
beautyManager.showPanel();
/// 3. Close the retouching panel (for Android).
beautyManager.hidePanel();
/// 4. Dispose the retouching object.
beautyManager.destroyBeauty();