SDK对接文档

主题

可玩主要注意游戏界面适配

介绍，是一种可以直接游玩的广告形态。

Unity版本推荐 ​

2021.3.39或2022.3.39

新建Unity空工程 ​

切换到Webgl ​

导入微信可玩广告插件库 ​


第一次导入编译以后，会提示导入微信插件，点击确定即可

新建首场景并添加到Buildsettings ​

编写核心玩法代码

API接入 ​

1. 初始化 ​

c#
//在脚本的Start方法里写入
void Start()
{
    SDKHandler.Instance.Init();
}

2. 通知可玩游戏结束 ​

WARNING

微信可玩在30秒时会自动结束，并跳转到结束页，此接口已废弃

c#
//可以在游戏结束的界面调用
SDKHandler.NotifyMiniProgramPlayableStatus();

下面介绍一种提前调用的示例：

试玩游戏设计为关卡模式，在关卡成功时，想提前跳转到结束页时，主动调用这个接口，通知试玩结束

跳转结束页行为只有在微信真机上面才会生效，效果如下

基础制作指导 ​

编写代码方案： ​

  • 不要使用框架，保证最小代码和资源

  • 不能使用Assetbudle加载，代码直接引用资源即可

使用资源方案： ​

  • 尽可能的使用最少的资源

  • 尽可能的让模型去做减面

  • 资源全部放在首场景进行引用

开启Hight代码裁剪 ​

打包 ​

编辑下基础功能验收完毕后，开始打包测试

微信小游戏/转换小游戏试玩-

打包会有两种模式，纯webgl模式和试玩广告模式。两种模式可在界面互切切换

1.纯Webgl模式 ​

本地部署进行网页测试，适合快速测试

切换到打非微信试玩广告模式

点击BuildWebgl,打包成功后会弹出打包成功的目录

本地部署调试 ​


使用的是nginx。搭建非常的简单。

强烈推荐端口使用80，这样访问时可以不用填写端口

复制文件到你的 本地cdn目录，并访问该文件 ​

本地cdn的路径在上面配置好以后，可以将需要远程访问的AB文件，构建对应的目录

举个例子：

plain text
cdn访问路径  http://本机ip:上文端口（比如 18081）/app-3/Test/msp_lt/DRGM/1.00/
文件路径 本地cdn根目录/app-3/Test/msp_lt/DRGM/1.00/
如何验证CDN是否成功。 ​

浏览器访问如下地址： http://你的ip:设置的端口号。能看到内容 非404即可。

如果看到的是一堆乱码，应该是因为你的该目录下面包含了一个index.html

叫到处的webgl应用放入cdn目录，直接访问该目录即可测试 ​

2. 微信试玩模式 ​

这个打包后需要使用微信小程序测试

必填如下：

  • appID和导出路径

  • 小游戏试玩项目名：开发者工具中展示的项目名，使用英文

  • 游戏方向：控制试玩是横屏还是竖屏，可选portrait-竖屏，landsc-横屏

生成后的产物如下：

交付 ​

1. html交付方式 ​

  • 将生成出来的 Build TemplateData index.html 压缩成zip，直接发送给我方运营同学即可。

2. 微信minigame压缩包 ​

  • 打微信试玩模式后，将微信可玩包直接压缩成zip，并拷贝到交付文件夹

  • 通知对应的测试使用微信开发者工具和微信真机测试

点我快速对接