sender.getMediaItems()、文件下载和群成员列表。处理用户上传文件时,优先用标准化 MediaItem,不要手动拼平台下载地址。
事件方法
getMediaItems()
getMediaItems() 查找顺序:
last_input_media_items:最近一次listen(...)/input(...)捕获到的媒体。media_items/mediaItems:当前运行上下文中的媒体数组。event_data.media_items/event_data.mediaItems:当前事件数据中的媒体数组。- 都不存在时返回
[]。
fileDownload(url, path?)
把远程 URL、file://、base64://... 或 data:*;base64,... 保存到本地。
downloadAdapterFile(file, options?, timeout?)
下载用户上传到 IM 平台的文件。优先把 sender.getMediaItems() 返回的整个 MediaItem 传进去。
用户上传文件项。对象可包含
source、url、file_id、id、file、path 或 platform_payload。传字符串时会当作文件来源;只有普通 URL 时也可以直接使用 fileDownload(url)。下载流程
- 如果
source已经是http://、https://、data:、base64://或file://,运行时直接下载。 - 如果
source是平台文件 ID 或其他不可直接下载标识,运行时调用适配器的resolveFileURL。 - 下载成功后保存到运行文件目录,返回本地路径。
getGroupMemberList(groupIDOrOptions?, options?, timeout?)
获取群成员列表。适配器必须支持 getGroupMemberList。
传字符串时表示群 ID。传对象时可包含
group_id、groupID、groupCode、group、chat_id、imType、account_id 等字段。不传群 ID 时会尝试使用当前群聊上下文。下一步
发送媒体
查看媒体发送和适配器差异。
主动推送
查看文件和 mixed 主动推送。