ZJSDK

SDK 初始化

SDK 初始化

此章节将演示如何在Unity项目中初始化ZJSDK。

初始化与启动

在进入应用后，通过ZJSDKUnity类的静态方法初始化 SDK

初始化分为ZJSDKUnity#InitWithoutStart(ZJConfig);方法与ZJSDKUnity#Start(IOnStartListener)两个方法。

两个方法需要按顺序调用，先调用InitWithoutStart方法配置初始化的信息，再在用户同意隐私政策后调用Start方法启动SDK，并确保启动成功后再请求广告。

方法参数说明
InitWithoutStart(ZJConfig config)config: 初始化配置信息配置初始化信息，可以在用户同意隐私政策前调用
Start(IOnStartListener listener)listener: 初始化状态回调启动SDK，需要在用户同意隐私政策后尽快调用

ZJConfig 说明

ZJConfig 为 SDK 的初始化信息配置

属性类型说明必填默认值
AppIdstring媒体ID√-
UserIdstring用户唯一ID×""
CustomControllerZJCustomController隐私控制
参照 隐私信息控制		×null
IsDebugbool是否为调试模式
调试模式，会输出调试日志		×false
Ageint用户年龄，仅针对海外市场
age 需要大于0		×0
GdprintGDPR授权，仅针对海外市场
-1为未知
0为用户未授权
1为用户授权		×-1
CoppaintCOPPA授权，仅针对海外市场
-1为未知
0为成人
1为儿童		×-1
CcpaintCCPA授权，仅针对海外市场
-1为未知
0为允许出售
1为不允许出售		×-1

初始化示例

Demo->Resources/ZJDemoRes/Scripts/UIMgr.cs
private void InitZJSDK()
{
    // 构建配置，可以在用户同意隐私政策前
    ZJSDKUnity.InitWithoutStart(new ZJConfig(AppId, UserId, customController: customController));
    // 启动SDK，需要在同意隐私政策后
    ZJSDKUnity.Start(new OnStartListener());
}

public class OnStartListener : ZJSDKUnity.IOnStartListener
{

    public void OnSuccess()
    {
        ShowToast("广告初始化成功");
    }

    public void OnError(int code, string msg)
    {
        ShowToast($"广告初始化失败失败: {code}|{msg}");
    }

}

示例工程

压缩包内的zjsdk_unity_demo.unitypackage包含了一个基础的SDK功能演示场景与对应的广告加载、展示示例代码：

演示页面广告加载
DemoDemo
目录