本文介绍使用 uni-app 框架,如何快速使用原生插件跑通示例源码,体验即时通讯服务。
在运行示例源码前,请确保开发环境满足以下要求:
已在 ZEGO 控制台 创建项目,获取到了接入 ZIM SDK 服务所需的 AppID、AppSign。ZIM 服务权限不是默认开启的,使用前,请先在 ZEGO 控制台 自助开通 ZIM 服务(详情请参考 项目管理 - 即时通讯),若无法开通 ZIM 服务,请联系 ZEGO 技术支持开通。
2.3.0 及以上
版本的 SDK,开始支持 “AppSign 鉴权”,同时仍支持 “Token 鉴权”,若您需要升级鉴权方式,可参考 ZIM 如何从 AppSign 鉴权升级为 Token 鉴权。
下列结构为 IM 源码文件的子目录结构,下文所涉及的文件路径均为相对于此目录的路径。
├── App.vue
├── assets
│ ├── js
│ │ ├── utils.js
├── components
├── index.html
├── main.js
├── manifest.json
├── pages
│ ├── action
│ │ ├── createC2C.vue
│ │ ├── createGroup.vue
│ │ ├── createRoom.vue
│ │ ├── joinGroup.vue
│ │ └── joinRoom.vue
│ ├── chat
│ │ ├── chat.vue
│ │ ├── info.vue
│ │ └── memberList.vue
│ ├── group
│ │ ├── group.vue
│ │ ├── info.vue
│ │ ├── memberAdd.vue
│ │ ├── memberDelete.vue
│ │ ├── memberList.vue
│ │ ├── modifyName.vue
│ │ ├── modifyNotice.vue
│ │ ├── modifyOwner.vue
│ │ └── modifyRemark.vue
│ ├── home
│ │ └── home.vue
│ └── login
│ └── login.vue
├── pages.json
├── static
│ ├── customicons.css
│ └── customicons.ttf
├── store
│ └── index.js
├── uni.scss
打开 HBuilderX,选择 “文件 > 导入 > 从本地目录导入”,导入示例源码文件。
打开 “assets/js” 文件夹下的 “config.js” 文件,并使用本文 3 前提条件 已获取的 AppID 、AppSign 和 ServerSecret 正确填写,并保存。
如果您的应用搭配 iOS、Android 使用:
export const appConfig = {
appID: , // 填写申请的 AppID
appSign: , // 填写申请的 AppSign,搭配 iOS/Android 平台时需要填写
};
如果您的应用搭配 Web、小程序使用:
export const appConfig = {
appID: , // 填写申请的 AppID
serverSecret: , // 填写申请的 ServerSecret,搭配 Web 平台时,需要生成 Token 使用
};
若您的项目已切换为 “Token 鉴权”,请在 ZEGO 控制台 上,申请临时 Token 用于调试。
在项目中导入插件,具体操作请参考 在 uni-app 项目中导入插件。
uni-app 官方自定义调试基座使用说明,请参考 什么是自定义调试基座及使用说明 。
选择 “运行 > 运行到手机或模拟器 > 制作自定义调试基座” 菜单。
在弹出的界面中,按照 uni-app 教程,填写相关信息,并单击“打包”进行云打包。
打包成功后,控制台会收到 uni-app 的相关提示。
自定义调试基座,请选择“运行 > 运行到手机或模拟器 > 运行基座选择 > 自定义调试基座”菜单。
请参考 uni-app 常见问题。
联系我们
文档反馈