UnityPlugin 使用说明
# UnityPlugin 使用说明
# 版本要求
使用 unity 要用 sdk 2.44.9 要集成扩展SDK,implementation 'com.finogeeks.mop:plugins:2.44.9'
基础库 3.3.5 或以上
# 如何使用
Unity 小游戏使用了一个微信平台上的 UnityPlugin
该 Plugin 在 finlip 平台无法直接下载
因此这里提供一个替换方案,这里以插件的 1.2.45 版本为例:
方案首先将小游戏对应版本的插件的代码拉取出来(微信开发者工具打开 unity 小游戏时,可以查看 source 并获取到相应代码),经过 babel.js 处理后,会输出一个插件代码目录
拿到插件代码后,有两种替换方式:
1、替换 unity 小游戏 game.js 的 requirePlugin 为本地引用的方式
小游戏原代码
// game.js
UnityManager = requirePlugin('UnityPlugin', {
enableRequireHostModule: true,
customEnv: {
wx,
unityNamespace,
document,
canvas,
events: GameGlobal.events,
WXWASMSDK: GameGlobal.WXWASMSDK,
},
}).default;
替换为
GameGlobal.unityNamespace = unityNamespace
GameGlobal.customEnv = {
wx,
unityNamespace,
document,
canvas,
events: GameGlobal.events,
WXWASMSDK: GameGlobal.WXWASMSDK,
}
GameGlobal.pluginEnv = {
isMiniGamePlugin: true,
coverview: wx.coverview || {
Component: function () {},
getPrivateThis: function () {
return {
loadingText: {},
loadPromise: Promise.resolve()
}
}
},
customEnv: GameGlobal.customEnv,
gameTransfer() {}
}
// 指向本地项目的插件目录
UnityManager = require('./plugin/dist/index', {
enableRequireHostModule: true,
customEnv: {
wx,
unityNamespace,
document,
canvas,
events: GameGlobal.events,
WXWASMSDK: GameGlobal.WXWASMSDK,
},
}).default;
2、将插件上传到 finclip 平台,然后替换插件 ID 及版本
小游戏 game.json 原代码
"plugins": {
"UnityPlugin" : {
"version" : "1.2.45",
"provider" : "wxe5a48f1ed5f544b7",
"contexts" : [
{
"type" : "isolatedContext"
}
]
}
},
小游戏 game.json 替换后代码
"plugins": {
"UnityPlugin" : {
"version" : "1.2.4501", // 仅展示用,实际版本号及 id 需要插件上传后才能确定
"provider" : "66308aed2c3c9800019e83b2",
"contexts" : [
{
"type" : "isolatedContext"
}
]
}
},
目前方案 1 只需要替换本地插件即可运行
方案 2 需要在相应环境上传插件,可先用方案 1 验证;方案二需要特定编译库版本
# 插件上传说明
本目录是一个 studio 插件工程目录
可以直接使用 studio 打开本目录,然后选择上传,接着选择环境中的插件 ID 及填写版本号即可

需要注意,fide.project.config.json 中,"pluginRoot" 表示当前插件的入口目录
比如 "pluginRoot": "1.2.38/dist" 即是使用的 1.2.38 版本,需要上传其他版本的插件时,可以修改该字段为其他版本文件夹
注意事项:
1、该插件工程仅用作上传,无法执行插件代码,所以 studio 会有插件报错,但不影响上传
2、上传时要在详情取消勾选 es6 转 es5,因为插件本身是经过编译处理的,无需再转换
3、建议上传时修改插件版本号跟微信插件版本号一样,比如:1.2.45 插件,上传时填写版本号为 1.2.45 或 1.2.451