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

背景:

最近公司新上的 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/

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