Skip to content

王帅 / ZAnti-Addiction-Unity

转到一个项目
切换导航栏
切换导航栏固定状态
Commit 9bf3e031 由 王帅
选项

readME

1 个父辈 29368fea
内嵌 并排
正在显示 7 个修改的文件 包含 77 行增加 和 325 行删除
README.md
...@@ -9,27 +9,19 @@ ...@@ -9,27 +9,19 @@
- 在 iOS 上部署 - 在 iOS 上部署
- Xcode 10 或更高版本 - Xcode 10 或更高版本
- iOS 9.0 或更高版本 - iOS 10.0 或更高版本
- [CocoaPods](https://guides.cocoapods.org/using/getting-started.html) - [CocoaPods](https://guides.cocoapods.org/using/getting-started.html)
- 在 Android 上部署
- 定位到 Android API 级别 14 或更高级别
- [Demo](https://github.com/yumimobi/AASDK-Unity)
## 下载防沉迷 Unity 插件 ## 下载防沉迷 Unity 插件
借助防沉迷 Unity 插件，Unity 开发者无需编写 Java 或 Objective-C 代码，即可轻松地在 Android 和 iOS 应用上实现防沉迷的功能。 借助防沉迷 Unity 插件，Unity 开发者无需编写 Java 或 Objective-C 代码，即可轻松地在 Android 和 iOS 应用上实现防沉迷的功能。
该插件提供了一个 C# 界面，用于 Unity 项目中 C# 脚本使用防沉迷功能。 该插件提供了一个 C# 界面，用于 Unity 项目中 C# 脚本使用防沉迷功能。
请通过如下链接下载该插件的 Unity 软件包，或在 GitHub 上查看其代码。 项目内的`ZAnti-AddictionSDK.unitypackage`文件即为Unity插件。
[下载插件](https://github.com/yumimobi/AASDK-Unity/releases/download/1.2.0/AASDK.unitypackage)
[查看源代码](https://github.com/yumimobi/AASDK-Unity)
### 导入防沉迷 Unity 插件 ### 导入防沉迷 Unity 插件
在 Unity 编辑器中打开您的项目，然后依次选择 Assets > Import Package > Custom Package，并找到您下载的 AntiAddictionSystem.unitypackage 文件。 在 Unity 编辑器中打开项目，然后依次选择 Assets > Import Package > Custom Package，并找到你下载的 AntiAddictionSystem.unitypackage 文件。
<img src='resources/add_custom_package.png'> <img src='resources/add_custom_package.png'>
...@@ -40,368 +32,128 @@ ...@@ -40,368 +32,128 @@
### 加入防沉迷 SDK ### 加入防沉迷 SDK
防沉迷 Unity 插件随 Unity Play [服务解析器库](https://github.com/googlesamples/unity-jar-resolver)一起发布。 此库旨在供需要访问 Android 特定库（例如 AAR）或 iOS CocoaPods 的所有 Unity 插件使用。它为 Unity 插件提供了声明依赖项的功能，然后依赖项会被自动解析并复制到 Unity 项目中。 防沉迷 Unity 插件随 Unity Play [服务解析器库](https://github.com/googlesamples/unity-jar-resolver)一起发布。 此库旨在供需要访问 Android 特定库（例如 AAR）或 iOS CocoaPods 的所有 Unity 插件使用。它为 Unity 插件提供了声明依赖项的功能，然后依赖项会被自动解析并复制到 Unity 项目中。
请按照下列步骤操作，确保您的项目包含防沉迷 SDK。
##### 1. 部署到 iOS ##### 1. 部署到 iOS
您无需执行其他步骤即可将防沉迷 SDK 加入 Unity 项目中。 无需执行其他步骤即可将防沉迷 SDK 加入 Unity 项目中。
*注意：iOS 依赖项的标识是通过 CocoaPods 完成的，而 CocoaPods 是构建过程完成后的一个运行步骤。* *注意：iOS 依赖项的标识是通过 CocoaPods 完成的，而 CocoaPods 是构建过程完成后的一个运行步骤。*
##### 2. 部署到 Android ##### 2. 部署到 Android
在 Unity 编辑器中，依次选择 Assets > External Dependency Manager > Android Resolver > Resolve。 暂未开通
Unity Play 服务解析器库会将声明的依赖项复制到 Unity 应用的 Assets/Plugins/Android 目录中。
*注意：防沉迷 Unity 插件依赖项位于 Assets/AntiAddictionSDK/Editor/AntiAddictionSDKDependencies.xml 中*
<img src='resources/force_resolve.png'> # 接入前准备
### 配置防沉迷SDK参数 ##### 配置iOS参数
`请在info.plist中进行如下配置，NSUserTrackingUsageDescription是为了获取IDFA权限，zgameid与zchannelid请联系掌游产品获取`
#### 配置 iOS 参数
请在info.plist中添加如下参数。
参数获取请联系产品。
```xml ```xml
<key>zgameid</key> <key>zgameid</key>
<string>your game id</string> <string>your game id</string>
<key>zchannelid</key> <key>zchannelid</key>
<string>your channel id</string> <string>your channel id</string>
<key>zplayKey</key>
<string>your zplayKey</string> <key>NSUserTrackingUsageDescription</key>
<string>IDFA权限获取说明</string>
``` ```
#### 配置 Android 参数 ##### 配置Apple登录
由于SDK中使用到了Apple登录，所以需要在iOS构建完毕后增加Apple登录权限如下：
请修改Assets/Plugins/Android/assets/ZplayConfig.xml文件中的参数 <img src='resources/signApple1.jpg'>
<img src='resources/android-setting.png'> <img src='resources/signApple2.jpg'>
<img src='resources/signApple3.jpg'>
`提示：ZplayConfig.xml文件中的GameID，ChannelID 参数，请联系掌游产品获取` 你可能会出现如下错误：
- "xxx" requires a provisioning profile with the Sign in with Apple feature.
- 点击了加号以后找不到Sign in with Apple的选项
这可能是因为你使用的配置文件没有开启Apple登录权限，请联系掌游产品获取正确的配置文件。
# 快速接入 # 接入
### 1. 创建 AntiAddictionSDK #### 创建 AntiAddictionSDK
```csharp ```csharp
using System; using System;
using UnityEngine; using UnityEngine;
using AntiAddictionSDK.Api; using AntiAddictionSDK.Api;
using AntiAddictionSDK.Common;
using AntiAddictionSDK;
using UnityEngine.SceneManagement;
using UnityEngine.UI; using UnityEngine.UI;
public class AASDKDemoScript : MonoBehaviour { public class AASDKDemoScript: MonoBehaviour
AntiAddictionStytemSDK antiAddictionSDK; {
AntiAddictionStytemSDK antiAddictionSDK;
void Start() public Text statusText;
{ // Start is called before the first frame update
antiAddictionSDK = new AntiAddictionStytemSDK(); void Start()
antiAddictionSDK.OnTouristsModeLoginSuccess += HandleTouristsModeLoginSuccess;
antiAddictionSDK.OnTouristsModeLoginFailed += HandleTouristsModeLoginFailed;
antiAddictionSDK.RealNameAuthenticateSuccess += HandleRealNameAuthenticateSuccess;
antiAddictionSDK.RealNameAuthenticateFailed += HandleRealNameAuthenticateFailed;
antiAddictionSDK.RealNameAuthenticateFailedWithForceExit += HandleRealNameAuthenticateFailedWithForceExit;
antiAddictionSDK.NoTimeLeftWithTouristsMode += HandleNoTimeLeftWithTouristsMode;
antiAddictionSDK.NoTimeLeftWithNonageMode += HandleNoTimeLeftWithNonageMode;
antiAddictionSDK.LeftTimeOfCurrentUserInEverySeconds += HandleLeftTimeOfCurrentUserInEverySeconds;
antiAddictionSDK.RealNameAuthSuccessStatus += HandleRealNameAuthSuccessStatus;
antiAddictionSDK.OnCurrentChannelUserInfo += HandleOnCurrentChannelUserInfo;
antiAddictionSDK.OnUserGroupSuccessResult += HandleOnUserGroupSuccessResult;
antiAddictionSDK.OnClickExitGameButton += HandleOnClickExitGameButton;
}
#region AntiAddictionStytemSDK callback handlers
// 游客登录回调
// 游客登录成功回调
public void HandleTouristsModeLoginSuccess(object sender, LoginSuccessEventArgs args)
{
//获取游客id
String touristsID = args.Message;
print("AntiAddiction---HandleTouristsModeLoginSuccess: " + touristsID);
}
// 游客登录失败回调
public void HandleTouristsModeLoginFailed(object sender, EventArgs args)
{
print("AntiAddiction---HandleTouristsModeLoginFailed");
}
// 实名认证回调
// 实名认证成功回调
public void HandleRealNameAuthenticateSuccess(object sender, EventArgs args)
{
print("AntiAddiction---HandleRealNameAuthenticateSuccess");
}
// 用户在实名认证界面点击暂不认证
public void HandleRealNameAuthenticateFailed(object sender, EventArgs args)
{
print("AntiAddiction---HandleRealNameAuthenticateFailed");
}
// 用户在实名认证界面点击退出游戏
public void HandleRealNameAuthenticateFailedWithForceExit(object sender, EventArgs args)
{ {
statusText.text = "HandleRealNameAuthenticateFailedWithForceExit"; antiAddictionSDK = new AntiAddictionStytemSDK();
print("AntiAddiction---HandleRealNameAuthenticateFailedWithForceExit"); antiAddictionSDK.ZAASDKCompleted += HandleZAASDKCompleted;
} }
// 游客账号可玩时长已结束回调 // 获取用户实名认证状态
public void HandleNoTimeLeftWithTouristsMode(object sender, EventArgs args) // 0: 未实名认证
{ // 1：已实名认证
print("AntiAddiction---HandleNoTimeLeftWithTouristsMode"); public void IsAuthenticated()
}
// 未成年人可玩时长已结束回调
public void HandleNoTimeLeftWithNonageMode(object sender, EventArgs args)
{
print("AntiAddiction---HandleNoTimeLeftWithNonageMode");
}
// 每秒回调当前用户剩余时间一次
public void HandleLeftTimeOfCurrentUserInEverySeconds(object sender, LeftTimeEventArgs args)
{ {
int leftTime = args.LeftTime; statusText.text = "IsAuthenticated";
print("AntiAddiction---HandleTouristsModeLoginSuccess: " + leftTime); if (antiAddictionSDK != null)
statusText.text = "HandleTouristsModeLoginSuccess: " + leftTime; {
statusText.text = antiAddictionSDK.IsAuthenticated()+"";
}
} }
// Android 当游戏调用UpdateDataReport接口后返回此回调通知游戏实名认证成功状态 // 获取当前用户年龄段
public void HandleRealNameAuthSuccessStatus(object sender, EventArgs args) // 0 未认证
// 1 成年人
// 2 未成年人
public void GetUserAgeGroup()
{ {
print("AntiAddiction---HandleRealNameAuthSuccessStatus: "); statusText.text = "GetUserAgeGroup";
statusText.text = "HandleRealNameAuthSuccessStatus: "; if (antiAddictionSDK != null)
{
statusText.text = antiAddictionSDK.AgeGroupOfCurrentUser()+"";
}
} }
// Android 联想渠道用户防沉迷实名认证状态
// 0：未实名认证
// 1：成年人
// 2：未成年人
public void HandleOnCurrentChannelUserInfo(object sender, ChannelUserInfoEventArgs args)
{
int realNameStatus = args.RealNameStatus;
print("AntiAddiction---HandleOnCurrentChannelUserInfo: " + realNameStatus);
statusText.text = "HandleOnCurrentChannelUserInfo: " + realNameStatus;
}
//Android 调用CheckUserGroupId接口后，会返回当前用户的分组状态（可选） // 获取当前用户剩余可玩时长
// -1 : 没获取到 // 如果为-1，表示当前用户为成年人账号，将不受防沉迷限制
// 1 : 新用户 // 如果为大于0的数，返回的为当前用户的剩余可玩时长，单位秒
// 2 : 老用户 public void LeftTimeOfCurrentUser()
public void HandleOnUserGroupSuccessResult(object sender, GroupIdEventArgs args)
{ {
int groupId = args.GroupId; statusText.text = "LeftTimeOfCurrentUser";
print("AntiAddiction---HandleOnUserGroupSuccessResult: " + groupId); if (antiAddictionSDK != null)
statusText.text = "HandleOnUserGroupSuccessResult: " + groupId; {
statusText.text = antiAddictionSDK.LeftTimeOfCurrentUser()+"";
}
} }
// 防沉迷流程结束，开始游戏
// Android SDK当用户点击实名认证页面上的退出游戏按钮后回调，游戏收到回调后请进行退出游戏处理 public void HandleZAASDKCompleted(object sender, EventArgs args)
public void HandleOnClickExitGameButton(object sender, EventArgs args)
{ {
print("AntiAddiction---HandleOnClickExitGameButton: "); statusText.text = "HandleZAASDKCompleted";
statusText.text = "HandleOnClickExitGameButton: "; print("AntiAddiction---HandleZAASDKCompleted");
} }
#endregion
} }
``` ```
### 2. 展示实名认证界面接口（暂不认证） # 自定义防沉迷画面
如果App在主界面有提供给用户实名认证的按钮，当用户点击实名认证按钮后，可调用下面的方法展示实名认证界面 当前SDK默认画面如下:
竖屏
<img src='resources/launch_V.png' width=200>
横屏
<img src='resources/launch_H.png' width=400>
```csharp 你可以通过加入图片资源来进行此界面的自定义：
if (antiAddictionSDK != null)
{
antiAddictionSDK.ShowRealNameView();
}
```
### 3. 展示实名认证界面接口（退出游戏） `增加图片资源并命名为'ZAA_Launch_Bg'来修改竖屏时的背景图片`
使用场景:
如果用户点击退出游戏，开发者需要在- (void)clickForceExitButtonOnRealNameAuthController;此回调中展示实名认证获取奖励界面（此界面由开发者自己实现），此界面提供两个交互按钮。
退出游戏按钮：点击此按钮退出游戏。
实名认证按钮：点击此按钮再次展示SDK提供的实名认证界面。
warning： 此时计时器暂停，开发者需要在认证成功回调中重启计时器- (void)resumeTimer;
```csharp
if (antiAddictionSDK != null)
{
antiAddictionSDK.ShowRealNameViewWithForceExit();
}
```
### 4. 展示用户剩余时长提示界面
每次进入游戏时调用。（成年人除外）
请在登录成功后调用。
```csharp
if (antiAddictionSDK != null)
{
antiAddictionSDK.ShowAlertInfoController();
}
```
### 5. 展示查看详情界面 `增加图片资源并命名为'ZAA_Launch_Bg_H'来修改横屏时的背景图片`
显示防沉迷规则
```csharp
if (antiAddictionSDK != null)
{
antiAddictionSDK.ShowCheckDetailInfoController();
}
```
### 6. 展示消费限制窗口 `增加图片资源并命名为'ZAA_Launch_StartButton'来修改开始按钮`
成年人无需展示
```csharp
if (antiAddictionSDK != null)
{
antiAddictionSDK.ShowCashLimitedController();
}
```
## 7 设置渠道UserId接口(Android 华为，联想渠道必选)
为兼容华为，联想渠道登录支付SDK进行实名认证兼容，游戏需要在华为联想登录之后，调用下面的接口设置渠道UserId。
注意: 华为，联想渠道防沉迷只有在调用下面的接口之后才会启动防沉迷的功能，否则将不会启动防沉迷SDK的任何功能
```java
//设置渠道UserId接口
//userId:华为，联想渠道登录SDK返回的用户Id
if (antiAddictionSDK != null)
{
antiAddictionSDK.SetChannelUserId(userId);
}
```
### 8. 其他接口
`注：在Android中，8.1及8.2为必须调用接口，8.3及8.4为非必须调用接口；在iOS中，以下接口均为非必须调用接口`
##### 8.1. 游戏退到后台接口（iOS无需调用）
此接口仅适用于Android，iOS平台无需调用。
当Android用户按home键，将游戏退出到后台时，请务必调用下面的接口
<span style="color:rgb(255,0,0);">
<b>重要提示：</b> 游戏退到后台接口必须调用，不调用会导致防沉迷SDK计算游戏时长错误
</span>
```csharp
if (antiAddictionSDK != null)
{
antiAddictionSDK.GameOnPause();
}
```
##### 8.2. 游戏恢复前台接口（iOS无需调用）
此接口仅适用于Android，iOS平台无需调用。
当Android用户将游戏恢复到前台时，请务必调用下面的接口
<span style="color:rgb(255,0,0);">
<b>重要提示：</b> 游戏恢复前台接口必须调用，不调用会导致防沉迷SDK计算游戏时长错误
</span>
```csharp
if (antiAddictionSDK != null)
{
antiAddictionSDK.GameOnResume();
}
```
##### 8.3. 获取用户实名认证状态
若需要获取当前用户的实名认证状态，可调用下面的接口进行获取
0: 未实名认证
1：已实名认证
```csharp
if (antiAddictionSDK != null)
{
int authenticatedStatus = antiAddictionSDK.IsAuthenticated();
}
```
##### 8.4. 获取当前用户剩余可玩时长
若需要获取当前用户的剩余可玩时长，可调用下面的接口进行获取
如果为-1，表示当前用户为成年人账号，将不受防沉迷限制
如果为大于0的数，返回的为当前用户的剩余可玩时长，单位秒
```csharp
if (antiAddictionSDK != null)
{
int leftTimeOfCurrentUser = antiAddictionSDK.LeftTimeOfCurrentUser();
}
```
##### 8.5 获取当前用户年龄区间
0: 未认证
1: 成年
2: 未成年
```csharp
if (antiAddictionSDK != null)
{
statusText.text = antiAddictionSDK.AgeGroupOfCurrentUser()+"";
}
```
##### 8.6 停止计时器
```csharp
if (antiAddictionSDK != null)
{
antiAddictionSDK.StopTimerInUnity();
}
```
##### 8.7 恢复计时器
```csharp
if (antiAddictionSDK != null)
{
antiAddictionSDK.ResumeTimerInUnity();
}
```
##### 8.8 获取UserCode(可选)
// 此接口仅适用于Android，iOS平台无需调用。
// Android 获取UserCode
```csharp
if (antiAddictionSDK != null)
{
string userCode = antiAddictionSDK.GetUserCode();
}
```
##### 8.9 设置用户GroupId(可选)
// 此接口仅适用于Android，iOS平台无需调用。
// Android 设置用户GroupId
```csharp
if (antiAddictionSDK != null)
{
antiAddictionSDK.SetGroupId(int groupId);
}
```
##### 8.10 获取用户GroupId(可选)
// 此接口仅适用于Android，iOS平台无需调用。
// Android 获取用户GroupId
```csharp
if (antiAddictionSDK != null)
{
antiAddictionSDK.GetGroupId();
}
```
##### 8.11 更新用户数据接口(可选)
// 此接口仅适用于Android，iOS平台无需调用。
// Android 更新用户数据接口
```csharp
if (antiAddictionSDK != null)
{
antiAddictionSDK.UpdateDataReport();
}
```
##### 8.12 检测当前用户的分组Id(可选)
// 此接口仅适用于Android，iOS平台无需调用。
// Android 获取当前用户的分组id，调用此方法后，会通过 event EventHandler<GroupIdEventArgs> OnUserGroupSuccessResult接口返回用户的分组信息
// zplayId:之前用户系统的zplayId，没有可以传""
```csharp
if (antiAddictionSDK != null)
{
antiAddictionSDK.CheckUserGroupId(string zplayId);
}
```
支持 Markdown 格式
你添加了 0 人 到此讨论。请谨慎行事。
Finish editing this message first!