Download media messages

Overview

The SDK provides download and cancel functionality for media files. For sending media messages, see the "Send a media message" section in Send a message.

Download a media message

Call mediaMessage.downloadMedia() on the media message instance.

Method

Dart

Future<int> downloadMedia({DownloadMediaMessageHandler? handler})

Code example

Dart

await (message as MediaMessage).downloadMedia(
  handler: DownloadMediaMessageHandler(
    onProgress: (message, progress) {
      print('Download progress: $progress%');
    },
    onCanceled: (message) {
      print('Download canceled');
    },
    onComplete: (code, message) {
      if (code == 0) {
        print('Downloaded to: ${message?.localPath}');
      }
    },
  ),
);

Cancel a media download

Call mediaMessage.cancelDownloadingMedia() on the media message instance.

Method

Dart

Future<int> cancelDownloadingMedia(OprationHandler<MediaMessage> handler)

Code example

Dart

await (message as MediaMessage).cancelDownloadingMedia((canceledMessage, error) {
  if (error == null) {
    print('Download canceled');
  }
});