跳到主要内容

下载与展示媒体消息

SDK 提供多媒体文件的下载功能，支持通过媒体消息中的地址下载文件。

下载媒体消息中的媒体文件​

如果消息 Message 对象中包含媒体消息内容（指 Message.content 为 MediaMessageContent 子类（如 FileMessage，ImageMessage, HQVoiceMessage 等），其中携带了媒体文件地址），可以使用 downloadMediaMessage 下载媒体文件。

提示
  • 首次下载媒体消息，SDK 会将媒体数据保存到 localPath 中返回。同一个媒体消息多次调用下载接口，SDK 只会下载一次。
  • 该方法已废弃，用 downloadMediaMessageWithProgress 替代。
TypeScript
    let messageId = 234;
    IMEngine.getInstance().downloadMediaMessage(messageId).then(result => {
      if (EngineError.Success === result.code) {
        // 本地路径
        let localPath = result.data as string;
      }
    });

下载媒体消息中的媒体文件（带下载进度）​

1.3.0 支持该功能，包含下载进度。

提示

首次下载媒体消息，SDK 会将媒体数据保存到 localPath 中返回。同一个媒体消息多次调用下载接口，SDK 只会下载一次。

SDK 下载媒体过程中，调用了 cancelDownloadMediaMessage() ，该方法会返回 EngineError.RequestCanceled。

TypeScript
let messageId = 123;
 IMEngine.getInstance().downloadMediaMessageWithProgress(messageId, (messageId: number, progress: number) => {
   // 下载进度，取值范围 [0 , 100]
 }).then(result => {
   if (EngineError.Success === result.code) {
     // 本地路径
     let localPath = result.data as string;
   }
 });

取消下载媒体消息​

1.3.0 支持该功能

提示

取消之后，再次调用下载方法，SDK 会重新下载。

TypeScript
let messageId = 123;
 IMEngine.getInstance().cancelDownloadMediaMessage(messageId).then(result => {
   if (EngineError.Success === result.code) {
     // 下载取消成功
   } else {
     // 下载取消失败
   }
 });

展示媒体消息​

展示图片消息​

在聊天页面展示图片消息的缩略图，点击图片消息进入图片预览时加载图片大图。鸿蒙的 Image 组件可以支持加载 base64 格式 ，本地路径和远端地址的图片。

展示图片 base64 缩略图​

  1. 创建 base64
TypeScript
// 此处 imgContent 简写
let imgContent : ImageMessage;

let imgBase64 = "data:image/png;base64," + imgContent.thumbnailBase64;

  1. 用 Image 控件展示 base64
TypeScript
Image(imgBase64).width(200)

展示图片大图​

  1. 获取大图地址工具方法
TypeScript
import fileUri from "@ohos.file.fileuri";


  private getImageUrl(imgContent: ImageMessage): string {
    // 如果本地路径存在
    if (StringChecker.isValid(imgContent.localPath)) {
      let localPath = imgContent.localPath;
      // 使用 fileUri 修正路径后返回本地路径
      localPath = fileUri.getUriFromPath(localPath);
      return localPath;
    }
    // 如果本地路径不存在，直接返回远端地址
    return imgContent.remoteUrl;
  }
  1. 获取大图地址
TypeScript
// 此处 imgContent 简写
let imgContent : ImageMessage;

let imgUrl = this.getImageUrl(imgContent);

  1. 用 Image 控件展示大图
TypeScript
Image(imgUrl).width(600)

播放高清语音消息​

语音播放器示例代码

详细参考：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/using-avplayer-for-playback-V5

TypeScript
// audioPath 为高清语音消息下载后的本地沙箱路径
let audioPath = "使用 downloadMediaMessage 下载成功的本地路径";
// 播放高清语音消息
AudioPlayer.playByPlayer(audioPath);
最后于 更新