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

© FinClip with ❤ , Since 2017