在摄影、短视频和社交类APP中,图片与视频往往是最值得分享的内容。用户在浏览作品时,希望把喜欢的照片快速传给朋友;在旅行过程中,也希望将刚拍摄的视频直接分享给同行者。传统操作通常需要先选择内容,再进入分享面板,寻找目标应用或者联系人。
HarmonyOS Share Kit的手机与手机碰一碰分享,为多媒体内容传递提供了更直接的入口。开发者需要做的,是根据内容类型构造正确的分享数据,并保证本地文件、预览图和接收端处理逻辑之间能够正确衔接。
以摄影APP为例,用户在作品详情页打开一张图片,希望将图片文件直接分享给朋友。首先需要获取图片在应用沙箱中的真实路径,再将路径转换为文件URI。不能直接把应用内部的普通文件路径当作分享数据提交。
import { fileUri } from '@kit.CoreFileKit';
import { uniformTypeDescriptor as utd } from '@kit.ArkData';
import { harmonyShare, systemShare } from '@kit.ShareKit';
private sharePhoto(
target: harmonyShare.SharableTarget,
photoPath: string
): void {
const photoUri = fileUri.getUriFromPath(photoPath);
const shareData: systemShare.SharedData =
new systemShare.SharedData({
utd: utd.UniformDataType.JPEG,
uri: photoUri,
thumbnailUri: photoUri
});
target.share(shareData);
}这里的JPEG表示分享内容的数据类型。实际开发时,需要根据真实文件格式选择合适的UTD类型,不能因为文件扩展名是图片就一律使用JPEG。对于PNG、其他图片格式以及视频文件,都应该根据官方UTD类型定义进行匹配。
图片分享还有一个重要问题:原图和预览图不一定需要使用同一个资源。用户可能希望传输高清原图,但系统分享卡片只需要一张尺寸较小的预览图。因此,应用可以在业务层准备两份资源,原图用于内容传递,缩略图用于分享预览。
对于视频分享,处理思路类似,但需要根据实际视频格式和UTD类型构造数据。下面以视频文件URI的准备为例:
const videoUri = fileUri.getUriFromPath(videoPath);
const videoShareData: systemShare.SharedData =
new systemShare.SharedData({
utd: utd.UniformDataType.MP4,
uri: videoUri
});
target.share(videoShareData);示例假设视频已经以MP4格式保存在应用沙箱中。实际工程中还要检查文件是否存在、文件大小是否符合业务要求,以及当前分享场景是否允许传输原始视频。不要在碰一碰回调触发后才临时进行耗时的视频转码,这会影响分享响应速度。
如果用户选择了多张图片,可以在业务层维护一个待分享列表。列表中的每个资源都需要有对应的URI和类型信息,再根据Share Kit支持的数据组织方式构建分享内容。不要只把图片路径拼接成一个字符串,否则接收端无法正确识别每个独立文件。
接收端则需要根据收到的数据类型进行分流。图片可以进入预览页面,视频可以进入播放器。如果收到的文件格式不受支持,应用应该明确提示用户,而不是直接打开一个空白页面。
private openReceivedContent(type: string, uri: string): void {
if (type === 'image') {
this.openImagePreview(uri);
return;
}
if (type === 'video') {
this.openVideoPlayer(uri);
return;
}
this.showUnsupportedMessage();
}上面的分流方法属于应用自己的业务逻辑,type和uri需要由Share Kit接收回调中的实际数据解析得到,并非系统直接提供的固定字符串字段。
多媒体分享还需要考虑隐私和版权。原始照片可能包含拍摄位置、时间等元数据,平台作品也可能受到版权限制。开发者应该明确分享的是原始文件、处理后的副本还是作品访问链接。对于仅允许在线浏览的内容,不应通过文件分享绕过原有的访问控制。
最后,测试不能只验证一张小图片。建议分别覆盖高清图片、长视频、多文件、文件损坏、资源不存在和存储空间不足等情况。只有从文件准备到接收预览的完整链路都正常,碰一碰分享才能真正成为多媒体APP的实用功能。
暂无评论数据
发布
相关推荐
24
0
22
0
34
0
16
0
22
0hot moon
我还没有写个人简介......
帖子
提问
粉丝
让AI开发真正融入日常工程:HarmonyOS开发助手模型配置与IDE协同实践
2026-11-12 11:36:52 发布



京公网安备:11010502051901号