Skip to content

ZAnti-Addiction / ZAnti-Addiction-Unity

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

read me

1 个父辈 24d1a289
内嵌 并排
正在显示 1 个修改的文件 包含 44 行增加 和 69 行删除
README.md
...@@ -19,6 +19,8 @@ Unity开发者不需要针对防沉迷规定进行功能开发，只需要在正 ...@@ -19,6 +19,8 @@ Unity开发者不需要针对防沉迷规定进行功能开发，只需要在正
- Android - Android
- 不支持 - 不支持
防沉迷 Unity 插件依赖 Unity Play [服务解析器库](https://github.com/googlesamples/unity-jar-resolver)。 此库旨在供需要访问 Android 特定库（例如 AAR）或 iOS CocoaPods 的所有 Unity 插件使用。它为 Unity 插件提供了声明依赖项的功能，然后依赖项会被自动解析并复制到 Unity 项目中。
# 集成步骤 # 集成步骤
#### 1. 获取 Unity 插件 #### 1. 获取 Unity 插件
...@@ -36,56 +38,46 @@ Import ...@@ -36,56 +38,46 @@ Import
<img src='resources/import_custom_package.jpg' width=300> <img src='resources/import_custom_package.jpg' width=300>
### 加入防沉迷 SDK #### 3. 构建 iOS 项目
<img src='resources/build_ios.jpg' width=300>
防沉迷 Unity 插件随 Unity Play [服务解析器库](https://github.com/googlesamples/unity-jar-resolver)一起发布。 此库旨在供需要访问 Android 特定库（例如 AAR）或 iOS CocoaPods 的所有 Unity 插件使用。它为 Unity 插件提供了声明依赖项的功能，然后依赖项会被自动解析并复制到 Unity 项目中。
##### 1. 部署到 iOS 进入构建项目目录，执行 `pod install`
无需执行其他步骤即可将防沉迷 SDK 加入 Unity 项目中。 此步骤是完成构建过程后步骤。依赖[CocoaPods](https://guides.cocoapods.org/using/getting-started.html)
*注意：iOS 依赖项的标识是通过 CocoaPods 完成的，而 CocoaPods 是构建过程完成后的一个运行步骤。*
##### 2. 部署到 Android
暂未开通
# 接入前准备 #### 4. 必要配置
##### 配置iOS参数 ##### info.plist
请在info.plist中进行如下配置： 在info.plist中进行如下配置：
- `NSUserTrackingUsageDescription`：是为了获取IDFA权限
- `zgameid`：请联系掌游产品获取 - `zgameid`：请联系掌游产品获取
- `zchannelid`：请联系掌游产品获取 - `zchannelid`：请联系掌游产品获取
```xml ```xml
<key>zgameid</key> <key>zgameid</key>
<string>your game id</string> <string>请联系掌游产品获取</string>
<key>zchannelid</key> <key>zchannelid</key>
<string>your channel id</string> <string>请联系掌游产品获取</string>
<key>NSUserTrackingUsageDescription</key>
<string>IDFA权限获取说明</string>
``` ```
##### 配置Apple登录 ##### Capabilities - 开启Apple登录
`由于SDK中使用了Apple登录，所以需要在iOS构建完毕后增加Apple登录权限`
1.<img src='resources/signApple1.jpg' width=400> 1. <img src='resources/signApple1.jpg' width=400>
2.<img src='resources/signApple2.jpg' width=400> 2. <img src='resources/signApple2.jpg' width=400>
3.<img src='resources/signApple3.jpg' width=400> 3. <img src='resources/signApple3.jpg' width=400>
你可能会遇到如下错误： 你可能会遇到如下错误：
- "xxx" requires a provisioning profile with the Sign in with Apple feature. - "xxx" requires a provisioning profile with the Sign in with Apple feature.
- 点击了加号以后找不到Sign in with Apple的选项 - 点击了加号以后找不到Sign in with Apple的选项
这可能是因为你使用的配置文件没有开启Apple登录权限，请联系掌游产品获取正确的配置文件。 这可能是因为你使用的 Provisioning Profile 文件没有开启Apple登录权限，请联系掌游产品获取正确的配置文件。
# 接入 # 如何使用
#### 创建 AntiAddictionSDK ##### 创建 AntiAddictionSDK
```csharp ```csharp
using System; using System;
...@@ -107,44 +99,6 @@ public class AASDKDemoScript: MonoBehaviour ...@@ -107,44 +99,6 @@ public class AASDKDemoScript: MonoBehaviour
antiAddictionSDK.ZAASDKCompleted += HandleZAASDKCompleted; antiAddictionSDK.ZAASDKCompleted += HandleZAASDKCompleted;
} }
// 获取用户实名认证状态
// 0: 未实名认证
// 1：已实名认证
public void IsAuthenticated()
{
statusText.text = "IsAuthenticated";
if (antiAddictionSDK != null)
{
statusText.text = antiAddictionSDK.IsAuthenticated()+"";
}
}
// 获取当前用户年龄段
// 0 未认证
// 1 成年人
// 2 未成年人
public void GetUserAgeGroup()
{
statusText.text = "GetUserAgeGroup";
if (antiAddictionSDK != null)
{
statusText.text = antiAddictionSDK.AgeGroupOfCurrentUser()+"";
}
}
// 获取当前用户剩余可玩时长
// 如果为-1，表示当前用户为成年人账号，将不受防沉迷限制
// 如果为大于0的数，返回的为当前用户的剩余可玩时长，单位秒
public void LeftTimeOfCurrentUser()
{
statusText.text = "LeftTimeOfCurrentUser";
if (antiAddictionSDK != null)
{
statusText.text = antiAddictionSDK.LeftTimeOfCurrentUser()+"";
}
}
// 防沉迷流程结束，开始游戏 // 防沉迷流程结束，开始游戏
public void HandleZAASDKCompleted(object sender, EventArgs args) public void HandleZAASDKCompleted(object sender, EventArgs args)
{ {
...@@ -154,18 +108,39 @@ public class AASDKDemoScript: MonoBehaviour ...@@ -154,18 +108,39 @@ public class AASDKDemoScript: MonoBehaviour
} }
``` ```
# 自定义防沉迷画面
# 可选配置
#### 开启IDFA
如果获取IDFA成功，SDK可以将IDFA与实名认证状态关联，用户完成一次实名认证后，在其他集成本SDK的游戏中可以实现免认证。
在info.plist中进行如下配置：
- `NSUserTrackingUsageDescription`：IDFA权限获取说明
```xml
<key>NSUserTrackingUsageDescription</key>
<string>IDFA权限获取说明</string>
```
#### 自定义防沉迷画面
当前SDK默认画面如下: 当前SDK默认画面如下:
竖屏 竖屏
<img src='resources/launch_V.jpg' width=150> <img src='resources/launch_V.jpg' width=150>
横屏 横屏
<img src='resources/launch_H.jpg' width=350> <img src='resources/launch_H.jpg' width=350>
你可以通过加入图片资源来进行此界面的自定义： 您可以通过像这样向项目添加图像来自定义此界面：
<img src='resources/ZAA_Launch_Bg_1.jpg' width=200>
<img src='resources/ZAA_Launch_Bg_2.jpg' width=200>
`增加图片资源并命名为 'ZAA_Launch_Bg' 来修改竖屏时的背景图片` ```xml
- 添加图片并命名为 'ZAA_Launch_Bg' 来修改竖屏时的背景图片
- 添加图片并命名为 'ZAA_Launch_Bg_H' 来修改横屏时的背景图片
- 添加图片并命名为 'ZAA_Launch_StartButton' 来修改开始按钮
```
`增加图片资源并命名为 'ZAA_Launch_Bg_H' 来修改横屏时的背景图片`
`增加图片资源并命名为 'ZAA_Launch_StartButton' 来修改开始按钮`
支持 Markdown 格式
你添加了 0 人 到此讨论。请谨慎行事。
Finish editing this message first!