写点什么

融云即时通讯 SDK 集成 -- 定制 UI(三) ——兼容 Android Q

发布于: 2021 年 03 月 15 日

背景:


最近公司新上的 app 要加上即时通讯的功能, 自己快速实现一个当然是不可能的了(项目 deadline 也顶不住哇).就从各家成熟的 SDK 厂商选来选去的, 各有各的好也各有各的不足.最后点兵点将,选了融云家的 SDK(老板说了算 hhhh).他家的官网和文档地址: 官网:https://www.rongcloud.cn/文档:https://docs.rongcloud.cn/v4


如何兼容 Android Q


Android 10 适配前言为了让用户更好地控制自己的文件,并限制文件混乱的情况,Android 10(Q) 修改了 APP 访问外部存储中文件的方法。外部存储的新特性被称为 Scoped Storage。


Android 10(Q) 仍然使用 READ_EXTERNAL_STORAGE 和 WRITE_EXTERNAL_STORAGE 作为面向用户的存储相关运行时权限,但现在即使获取了这些权限,访问外部存储也受到了限制。APP 需要这些运行时权限的情景发生了变化,且各种情况下外部存储对 APP 的可见性也发生了变化 在 Scoped Storage 新特性中,外部存储空间被分为两部分:


● 公共目录:Downloads、Documents、Pictures 、DCIM、Movies、Music、Ringtones 等


公共目录下的文件在 APP 卸载后,不会删除。


APP 可以通过 SAF(System Access Framework)、MediaStore 接口访问其中的文件。


● App-specific 目录


APP 卸载后,数据会清除。


APP 的私密目录,APP 访问自己的 App-specific 目录时无需任何权限。


融云关于 Android 10(Q)适配之前 SDK 将媒体文件存储于 /sdcard/RongCloud/Media 中,所以在 android 10(Q) 系统上会有聊天无法使用的情况,新版本更新后,会将媒体消息存储于 :sdcard/Android/data/包名/files/ 中,以保证 sdk 功能的正常使用


用户需要做的适配工作 1.如果您是 kit 的用户,我们对融云基本消息类型进行了全面兼容,如果您自定义了媒体消息,建议您在点击自定义媒体消息时,对本地文件进行检查,如果本地文件流无法读取,调用 RongIM 的 downloadMediaMessage() 方法重新下载更新本地路径


示例代码


//1.判断小视频本地文件是否存在
复制代码


if (sightMessage.getLocalPath() != null && !TextUtils.isEmpty(sightMessage.getLocalPath().toString())) {
复制代码


            return FileUtils.isFileExistsWithUri(this, sightMessage.getLocalPath());
复制代码


        } else {
复制代码


            return false;
复制代码


        }
复制代码


复制代码


//2.调用 downloadMediaMessage 下载文件刷新 ui
复制代码


  RongIM.getInstance().downloadMediaMessage(mMessage, downloadMediaMessageCallback);
复制代码

2.如果您是 lib 的用户,建议您在用户使用到媒体类型消息时,对消息体中的 localPath 进行判断检查,如果本地文件流无法正常访问,请调用 RongIMClient 的 downloadMediaMessage() 方法对媒体文件进行重新下载并更新本地路径,具体代买可参考以上代码进行具体调整


备注文件存储路径变化


不开启 rc_q_storage_mode_enable 的各种文件保存路径
复制代码


//使用sight模块录制小视频时
复制代码


录制视频:sdcard/sdcard/RongCloud/Image/应用名/image/
复制代码


复制代码


下载音频 /sdcard/RongCloud/Media
复制代码


下载视频 /sdcard/RongCloud/Media
复制代码


下载文件 /sdcard/RongCloud/Media
复制代码


下载 gif /sdcard/RongCloud/Media
复制代码


自定义媒体文件 /sdcard/RongCloud/Media
复制代码


复制代码


开启 rc_q_storage_mode_enable 的各种文件保存路径
复制代码


//使用sight模块录制小视频时
复制代码


录制视频:sdcard/Android/data/包名/files/RongCloud/video/
复制代码


复制代码


下载音频:sdcard/Android/data/包名/files/RongCloud/audio/
复制代码


下载视频:sdcard/Android/data/包名/files/RongCloud/video/
复制代码


下载文件:sdcard/Android/data/包名/files/RongCloud/file/
复制代码


下载 gif:sdcard/Android/data/包名/files/RongCloud/image/
复制代码


自定义媒体文件 会根据媒体类型存储到以上目录中
复制代码


用户头像

还未添加个人签名 2021.01.26 加入

还未添加个人简介

评论

发布
暂无评论
融云即时通讯SDK集成 -- 定制UI(三) ——兼容Android Q