网易云信 IM

接入

• 去 云信控制台 创建应用，拿到 App Key 后在 initSdk 里传入 appKey；账号 ID 与 Token 由业务服务端签发（云信控制台可查看测试账号）；
• 离线推送需在云信控制台上传华为推送证书，并把证书名称通过 initSdk 的 pushCertificateName 传入，同时保证应用已配置与该证书对应的推送 client_id，否则不会下发厂商离线推送；
• 已内置云信官方 IM 界面套件（10.9.60），包含会话列表、通讯录、单聊、群聊、个人资料、会话设置等完整界面，业务方只需依赖本插件、不需要再注册其他模块；
• 会话列表默认使用本地会话（支持离线会话数据、会话分组），可在 initSdk 中把 localConversation 设为 false 切换为云端会话，切换后本地会话数据不再使用；
• 聊天内拍照、拍摄视频、发送语音会用到相机与麦克风权限，插件已在使用时由界面套件申请，用户在系统弹窗中拒绝时功能不可用；
• 聊天内发送位置、查看位置详情走系统地图服务（华为 Map Kit 的地点选点与地点详情，不是高德/百度等三方地图，插件无需填写任何地图 Key）：需要应用在 AppGallery Connect 开通地图服务，并使用与该应用一致的 client_id，否则发送位置只有失败日志（1002600003 应用鉴权失败、1002600004 未开通地图权限），界面停留在聊天页；发送位置前会自动申请定位权限，定位权限被拒绝时提示无权限；
• 打开界面之前必须先调用 login，未登录时界面与聊天接口返回错误码 NOT_LOGGED_IN；未调用 initSdk 时返回 NOT_INITIALIZED，initSdk 未传 appKey 时按缺少参数返回；
• 套件界面为浅色设计：打开消息页时插件会把宿主临时切到浅色模式（退出该页恢复跟随系统），并把状态栏文字切成深色，避免套件未绘制区域在深色模式下显示为黑色（2in1 设备不支持该切换）；
• 聊天内「音视频通话」已接入云信音视频通话组件（CallKit + NERtc，随插件内置）：需在云信控制台开通音视频通话服务，否则发起通话会以 The signalling service is disabled. Please enable it first. 失败并弹提示；通话使用相机与麦克风权限（已声明），视频通话在没有摄像头的设备上不可用；
• AI 相关能力都需先在云信控制台开通：聊天输入区的「回复灵感」（AI 助聊）由 initSdk 的 aiChatHelper 控制，未开通时点击会提示「回复灵感获取失败」（服务端返回没有权限）；划词搜索与 AI 翻译需先在控制台添加对应的 AI 数字人，并把数字人账号 ID 填到 initSdk 的 aiSearchAccountId、aiTranslateAccountId，否则聊天里不会出现这两个入口；
• 初始化需在用户同意隐私政策之后调用，未确认隐私政策时返回错误码 PRIVACY_NOT_AGREED；
• 离线推送默认开启，可用 setPushEnabled 关闭或重新开启；电脑端在线时手机端是否继续接收推送用 setMobileOnDesktopOnline 设置；
• 事件通过 setListener 接收，eventName 固定为 event，data 为 { action, data }：loginStatus、connectStatus、loginFailed、kickedOffline、messageReceived、unreadCount、friendApplication、teamInvitation；
• 失败时返回云信 SDK 原始错误信息与错误码，Token 过期、被踢下线等情况通过 loginFailed、kickedOffline 事件回传，需要业务重新登录。

js API

按使用场景分组，调用方式：

const im = ymx.requirePlugin('ymx-yunxin-im');
await im.initSdk({ appKey: '你的 AppKey', pushCertificateName: '华为推送证书名' });
await im.login({ accountId: 'account1', token: 'token' });

更多 API 详情（参数、返回值、示例）...

初始化与登录

打开界面

选择页（带回传）

会话分组

本地消息与迁移

收藏

群邀请与申请

话题与快捷评论

免打扰与推送

消息发送

消息查询与操作

会话

个人资料

好友、用户与黑名单

群与群成员

在线状态订阅

AI 能力

旧版 jsBridge 兼容

navigate 的 path：