七鱼开发文档中心
总览服务端 APIWebiOSAndroid鸿蒙Uniapp微信小程序插件三方接入

插件接入

本节说明如何将网易七鱼 Uniapp 原生插件导入项目,并完成 AppKey 配置和调试基座制作。原生插件的通用导入流程也可以参考 Uniapp 官方文档。

导入原生插件

将插件包导入到 Uniapp 工程的 nativeplugins 目录中。如果项目中没有该目录,可以在项目根目录手动创建。

目录示例:

your-uniapp-project/
  nativeplugins/
    Netease-QiyuModule/

配置 AppKey

在 manifest.json 中配置原生插件:

  1. 打开 manifest.json。
  2. 进入「App 原生插件配置」。
  3. 选择「本地插件」。
  4. 导入七鱼插件包。
  5. 填入七鱼管理后台申请到的 appKey。

如果没有配置 appKey,运行时会提示“请在原生插件配置里面填入网易七鱼appKey”。

制作自定义调试基座

因为七鱼 Uniapp 插件是原生 SDK 插件,普通基座无法直接运行插件能力。调试前需要在 HBuilderX 中制作自定义调试基座:

运行 -> 运行到手机或模拟器 -> 制作自定义调试基座

制作时选择对应平台和打包证书。

安装应用

自定义调试基座制作完成后,在 HBuilderX 中运行到对应 App 基座:

运行 -> 运行到手机或模拟器 -> 运行到 Android App 基座
运行 -> 运行到手机或模拟器 -> 运行到 iOS App 基座

安装的是带有七鱼原生插件的 App 包。安装完成后,再按使用流程调用插件 API。

这篇文档有帮助吗?

目录