浏览 SDKs · Android
平台
SDKsAndroid

使用 URL 创建图片消息

使用已上传的远端图片 URL 创建图片消息对象。

复制

使用已上传至业务自有云存储或第三方 CDN 的图片 URL 创建图片消息对象。SDK 不会再次对图片执行上传,适用于业务自行管理文件存储的场景。

String sourceURL = "https://example.com/images/origin.jpg";

PictureInfo sourcePicture = new PictureInfo();
sourcePicture.setUrl(sourceURL);
sourcePicture.setWidth(1080);
sourcePicture.setHeight(1920);

PictureInfo bigPicture = sourcePicture;

PictureInfo snapshotPicture = new PictureInfo();
snapshotPicture.setUrl("https://example.com/images/thumb.jpg");
snapshotPicture.setWidth(200);
snapshotPicture.setHeight(355);

Message message = OpenIMClient.getInstance().messageManager.createImageMessageByURL(
    sourceURL,
    sourcePicture,
    bigPicture,
    snapshotPicture
);

参数说明

参数类型是否必填说明
sourceURLString是已上传原图的远端可访问 URL。
sourcePicturePictureInfo是原图信息对象,包含 URL、宽、高以及文件大小等。
bigPicturePictureInfo是大图信息对象。若未单独生成大图,可直接传入原图信息。
snapshotPicturePictureInfo是缩略图信息对象,用于聊天列表中快速预览。

返回结果

返回创建完成的待发送 Message 对象,其 contentType 为 MessageType.PICTURE。

由于图片资源已由外部上传,发送该消息时应调用发送不经 OSS 的消息直接投递,避免重复上传。