# SDK 调用微信 API

# 初始化

调用Unity SDK前，需要在主入口进行SDK初始化，回调后再执行主逻辑。

WX.InitSDK((int code)=> {
// 你的主逻辑
});

# 支持范围

本Unity SDK对WXSDK的支持大体与官网 API 文档相同。

具体支持的 API 可以查看WX.cs文件，其中有详细注释说明。

# 更新机制

新版Unity SDK会在lib.wx.api.d.ts更新后及时更新。 若基础库更新后lib.wx.api.d.ts暂未更新，开发者可参考自定义SDK调用临时调用WXSDK。 以wx.shareAppMessageToGroup为例：

using WeChatWASM;

public class ShareAppMessageToGroupOption
{
    public string title;
    public string path;
    public string imageUrl;
}

// 合适位置调用
WX.CallJSFunction("wx", "shareAppMessageToGroup", new ShareAppMessageToGroupOption
{
    title = "群任务",
});

# Unity SDK 特供API

此处列出lib.wx.api.d.ts中未列出，仅在Unity SDK中可用的API列表。

# 暂未支持的WXAPI

暂未支持的WXAPI中有一部分接口需要在开放数据域调用，故暂无法支持。

# 调用方法

Unity 版本的 API 大体与官网 API 文档的 JS 版本 API 类似，使用时可以参考。

如 JS 版的 banner 广告的调用如下：

var bannerAd = wx.createBannerAd({
    adUnitId: "xxxx",
    adIntervals: 30,
    style: {
        left: 0,
        top: 0,
        width: 600,
        height: 200,
    },
});
bannerAd.onLoad(() => {
    bannerAd.show();
});
bannerAd.onError((res) => {
    console.log(res);
});

而对于 Unity 版的调用如下：

var bannerAd = WX.CreateBannerAd(new WXCreateBannerAdParam()
{
    adUnitId = "xxxx",
    adIntervals = 30,
    style = new Style()
    {
        left = 0,
        top = 0,
        width = 600,
        height = 200
    }
});
bannerAd.OnLoad(()=> {
    bannerAd.Show();
});
bannerAd.OnError((WXADErrorResponse res)=>
{
    Debug.Log(res.errCode);
});

大体是将 JS 版中的wx替换为 Unity 版的WX,然后对应方法名首字母由小写改为大写，如createBannerAd就变为CreateBannerAd

# 基础库

• 基础库介绍
• 基础库版本分布

# 在 Unity 中兼容低版本基础库

使用WX.CanIUse可以判断当前版本是否支持该 API（仅支持 wx），例如想要判断当前环境WX.ReportScene是否可用，可以用WX.CanIUse("ReportScene")来判断

# 开发建议

# API 示例

使用示例我们会逐渐补充到Demo, 其中 API 项目为常见使用范例，请优先查阅用法。

# 联调效率

如果开发者有简单的 JS 代码经验，建议先以 JS 方式直接修改 minigame 的 JS 代码进行调试，完成之后再使用 C# SDK 修改 Unity 工程：

1. 只保留 game.js 前面 import 部分，其余删除，即不运行游戏逻辑。
2. 增加以下代码：

const gl = GameGlobal.canvas.getContext("webgl");
gl.clear(gl.COLOR_BUFFER_BIT);

3. 使用 JS 编写需要调试的 API

# 注意事项

1. 广告接口是否需要上线后才能调试

• 是的，需要上线并累计 UV>1000 才可以开通广告主