See the English Guide

ZAnti-AddictionSDK 是什么

根据2019年10月15日发布的《关于防止未成年人沉迷网络游戏的通知》，游戏用户需使用有效身份证件进行实名认证。

未成年用户仅可在周五、周六、周日和法定节假日每日20时至21时游玩1小时，其他时间均不得以任何形式向未成年人提供游戏服务。

Unity开发者不需要针对防沉迷规定进行功能开发，只需要在正常的游戏代码上接入本SDK并进行初始化即可。

平台支持

• iOS

  • Xcode 10 或更高版本
    
  • iOS 10.0 或更高版本
    
  • CocoaPods
    

• Android

  • 不支持

防沉迷 Unity 插件依赖 Unity Play 服务解析器库。 此库旨在供需要访问 Android 特定库（例如 AAR）或 iOS CocoaPods 的所有 Unity 插件使用。它为 Unity 插件提供了声明依赖项的功能，然后依赖项会被自动解析并复制到 Unity 项目中。

集成步骤

1. 获取 Unity 插件

点此下载 ZAnti-AddictionSDK.unitypackage

或直接使用本项目内的ZAnti-AddictionSDK.unitypackage文件。

2. 导入

在 Unity 编辑器中打开项目，然后依次选择 Assets > Import Package > Custom Package，并找到你下载的 ZAnti-AddictionSDK.unitypackage 文件并导入。

Import

3. 构建 iOS 项目

进入构建项目目录，执行 pod install

此步骤是完成构建过程后步骤。依赖CocoaPods

4. 必要配置

info.plist

在info.plist中进行如下配置：

• zgameid：请联系掌游产品获取

• zchannelid：请联系掌游产品获取

  <key>zgameid</key>
  <string>请联系掌游产品获取</string>
  
  <key>zchannelid</key>
  <string>请联系掌游产品获取</string>
  

Capabilities - 开启Apple登录

1. 

2. 

3. 

你可能会遇到如下错误：

• "xxx" requires a provisioning profile with the Sign in with Apple feature.
• 点击了加号以后找不到Sign in with Apple的选项

这可能是因为你使用的 Provisioning Profile 文件没有开启Apple登录权限，请联系掌游产品获取正确的配置文件。

如何使用

创建 AntiAddictionSDK

using System;
using UnityEngine;
using AntiAddictionSDK.Api;
using AntiAddictionSDK.Common;
using AntiAddictionSDK;
using UnityEngine.SceneManagement;
using UnityEngine.UI;

public class AASDKDemoScript: MonoBehaviour
{
    AntiAddictionStytemSDK antiAddictionSDK;
    public Text statusText;
    // Start is called before the first frame update
    void Start()
    {
        antiAddictionSDK = new AntiAddictionStytemSDK();
        antiAddictionSDK.ZAASDKCompleted += HandleZAASDKCompleted;
    }

    // 防沉迷流程结束，开始游戏
    public void HandleZAASDKCompleted(object sender, EventArgs args)
    {
        statusText.text = "HandleZAASDKCompleted";
        print("AntiAddiction---HandleZAASDKCompleted");
    }
}

可选配置

开启IDFA

如果获取IDFA成功，SDK可以将IDFA与实名认证状态关联，用户完成一次实名认证后，在其他集成本SDK的游戏中可以实现免认证。

在info.plist中进行如下配置：

• NSUserTrackingUsageDescription：IDFA权限获取说明 xml <key>NSUserTrackingUsageDescription</key> <string>IDFA权限获取说明</string>

自定义防沉迷画面

当前SDK默认画面如下: 竖屏

横屏

您可以通过像这样向项目添加图像来自定义此界面：

- 添加图片并命名为 'ZAA_Launch_Bg' 来修改竖屏时的背景图片

- 添加图片并命名为 'ZAA_Launch_Bg_H' 来修改横屏时的背景图片

- 添加图片并命名为 'ZAA_Launch_StartButton' 来修改开始按钮