头像（Avatar）

头像：Avatar 是 IDL 定义的跨端 UI 组件，props / events / behaviors 在各平台语义一致。本页给出契约属性、事件、渲染行为、数据源与 iOS 端绑定/示例。

契约属性（props）​

属性类型必填说明
userIdstring是用户 ID（用于生成首字与稳定背景色）
namestring否显示名称（可选，缺省取 userId）
urlstring否头像 URL（加载失败回退首字）
sizeint否头像尺寸（像素）

事件​

该组件未声明事件；交互通过属性和宿主回调完成。

渲染行为​

  • url 缺失或加载失败时显示姓名首字/末字，背景色由 userId 哈希稳定生成

数据源​

未在 IDL 声明 dataSource；由宿主从 IMLib 拉取（getConversationList / getHistoryMessages / MESSAGES / CONVERSATION 事件）。

依赖边界

组件不直连网络与数据库：会话/消息由宿主从 IMLib 拉取后传入，组件只做排序、角标、格式化与渲染。

平台绑定​

项值
公开符号 / 签名IMPAvatar
导出列表包含是
UI 框架UIKit 视图容器 + 组件协议（Swift / Objective-C 双接口），宿主负责装配页面

使用示例​

Objective-C 示例已隐藏（含未导出符号）

该示例引用了 SDK 头文件未导出的符号（多为 Swift 专用 helper）。请使用下表真实 ObjC 类，或参考对应组件页的 Objective-C 接入说明。

可用 ObjC 类用途
IMPOSClientIMLib 客户端（连接、消息、会话、群组等）
IMPOSChatViewControllerIMKit 会话页（真实 ObjC 类）
IMPOSConversationListViewControllerIMKit 会话列表页（真实 ObjC 类）
IMPOSGlobalChatViewControllerGlobal UIKit 会话页（真实 ObjC 类）
IMPOSGlobalChatListViewControllerGlobal UIKit 会话列表页（真实 ObjC 类）
let view = AvatarView(userId: "user2", name: "Bob")
container.addSubview(view)

相关文档​