Merge pull request #1283 from taptap/feat_4.5.0

feat: update version 、 releaseNote and IAP doc for 4.5.0
taptap · Nov 18, 2024 · 3feef37 · 3feef37
2 parents e15d5fd + 35a8b4e
commit 3feef37
Show file tree

Hide file tree

Showing 21 changed files with 1,650 additions and 47 deletions.
diff --git a/cn/docs/sdk/_partials/unity-sdk-installation.mdx b/cn/docs/sdk/_partials/unity-sdk-installation.mdx
@@ -31,30 +31,6 @@ SDK 内部使用了部分第三方库，开发者接入时需先确保 SDK 外
 }
 ```
 
-:::tip
-
-如果需要接入 TapSDK Unity PC 平台，需要在使用 NuGet 集成工具，集成 `K4os.Compression.LZ4` , `protobuf-net` 两个库，具体设置如下：
-
-- 在 `Packages/manifest.json` 添加如下依赖：
-```json
-"com.github-glitchenzo.nugetforunity": "https://github.com/GlitchEnzo/NuGetForUnity.git?path=/src/NuGetForUnity"
-```
-- 添加完后，在 Unity 顶部菜单中如果没有出现 **NuGet**选项，可以重启 Unity 编辑器，包括 Unity Hub 客户端。
-- 在 Unity 顶部菜单中选择 **NuGet > Manage NuGet Packages**，在弹出的窗口中搜索 `K4os.Compression.LZ4` 和 `protobuf-net` 并安装。
-
-  最终会在 Assets文件夹下的 packages.config 文件中自动生成如下依赖：
-```xml
-<?xml version="1.0" encoding="utf-8"?>
-<packages>
-  <package id="K4os.Compression.LZ4" version="1.3.8" manuallyInstalled="true" />
-  <package id="System.Collections.Immutable" version="7.0.0" />
-  <package id="System.Runtime.CompilerServices.Unsafe" version="6.0.0" />
-  <package id="protobuf-net" version="3.2.30" manuallyInstalled="true" />
-  <package id="protobuf-net.Core" version="3.2.30" />
-</packages>
-```
-:::
-
 ### 添加 SDK 依赖
 
 SDK 支持** Unity Package Manager ** 及本地文件导入两种集成方式，开发者根据需求选择其中一种即可，推荐使用远程依赖。

diff --git a/cn/docs/sdk/embedded-moments/guide.mdx b/cn/docs/sdk/embedded-moments/guide.mdx
@@ -71,11 +71,13 @@ import v4SDKVersions from '/src/docComponents/v4SDKVersions';
 使用内嵌动态服务需要相册、相机权限，所以开发者需在工程的 `info.plist` 配置相关权限并**替换授权文案**：
 
 ```xml
-<!--使用内嵌动态服务，需要相册、相机权限-->
+<!--使用内嵌动态服务，需要相册、相机、麦克风权限-->
 <key>NSPhotoLibraryUsageDescription</key>
 <string>说明为何应用需要此项权限</string>
 <key>NSCameraUsageDescription</key>
 <string>说明为何应用需要此项权限</string>
+<key>NSMicrophoneUsageDescription</key>
+<string>说明为何应用需要此项权限</string>
 ```
 
 </>
@@ -130,11 +132,13 @@ unitypackageModules={[
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
 <dict>
-    <!--使用内嵌动态服务，需要相册、相机-->
+    <!--使用内嵌动态服务，需要相册、相机、麦克风-->
     <key>NSPhotoLibraryUsageDescription</key>
     <string>说明为何应用需要此项权限</string>
     <key>NSCameraUsageDescription</key>
     <string>说明为何应用需要此项权限</string>
+    <key>NSMicrophoneUsageDescription</key>
+    <string>说明为何应用需要此项权限</string>
 </dict>
 </plist>
 ```
@@ -702,7 +706,7 @@ let postData = TapTapMomentImageData()
 // 设置发布的文字内容
 postData.content = "动态文字内容"
 // 设置发布的图片地址
-let imagePath = "file://..."
+let imagePath = "/var/mobile/**.png"
 postData.images = [imagePath]
 // 发布图文动态
 TapTapMoment.publish(postData)

diff --git a/cn/docs/sdk/start/agreement.mdx b/cn/docs/sdk/start/agreement.mdx
@@ -2,9 +2,8 @@
 title: TapSDK 隐私政策
 sidebar_position: 8
 ---
-
-更新日期：2024 年 9 月 30 日  
-生效日期：2024 年 9 月 30 日
+更新日期：2024 年 11 月 15 日
+生效日期：2024 年 11 月 15 日
 
 易玩（上海）网络科技有限公司（以下简称“TapTap”或“我们”）通过 TapSDK 向开发者提供多种服务，开发者可以根据自身需求在其应用中接入其中任意一项或多项服务。本文档将向开发者和其用户（以下或称“玩家”）说明 TapSDK 的隐私安全信息，包括 TapSDK 各项服务处理的个人信息范围、处理目的、权限使用情况等。
 
@@ -381,7 +380,7 @@ sidebar_position: 8
 	<tr>
 	    <th>个人信息/权限类型</th>
 	    <th>个人信息/权限名称</th>
-	    <th>使用目的</th>  
+	    <th>使用目的</th>
 	</tr >
 	<tr >
 	    <td rowspan="7">必要个人信息/权限</td>
@@ -425,7 +424,7 @@ sidebar_position: 8
 	<tr>
 	    <th>个人信息/权限类型</th>
 	    <th>个人信息/权限名称</th>
-	    <th>使用目的</th>  
+	    <th>使用目的</th>
 	</tr >
 	<tr >
 	    <td rowspan="7">必要个人信息/权限</td>
@@ -460,6 +459,48 @@ sidebar_position: 8
 
 
 
+**1.2.10 TapTap IAP**
+
+1）功能介绍：提供 TapTap IAP(In App Purchase)能力，玩家可以通过 TapTap IAP 快速购买所需要的游戏道具，最终会通过微信支付、支付宝支付等方式完成支付。
+
+2）收集信息/获取权限
+<table>
+	<tr>
+	    <th>个人信息/权限类型</th>
+	    <th>个人信息/权限名称</th>
+	    <th>使用目的</th>
+	</tr >
+	<tr >
+	    <td rowspan="7">必要个人信息/权限</td>
+	    <td>系统版本</td>
+	    <td rowspan="7">为了确保设备系统兼容、定位解决问题</td>
+	</tr>
+	<tr>
+	    <td>设备型号</td>
+	</tr>
+	<tr>
+	    <td>设备 CPU 信息</td>
+	</tr>
+	<tr>
+	    <td>网络类型</td>
+	</tr>
+	<tr>
+	    <td>AndroidID</td>
+	</tr>
+	<tr>
+	    <td>设备内存信息</td>
+	</tr>
+	<tr>
+	    <td>手机样式</td>
+	</tr>
+	<tr>
+	    <td>可选个人信息/权限</td>
+		<td>无</td>
+	    <td>/</td>
+	</tr>
+</table>
+
+
 
 1.3 我们仅为实现 TapSDK 产品和/或服务功能，对所收集的用户个人信息进行处理。若需要将收集的个人信息用于其他目的，我们会以合理方式告知用户，并在获得用户的同意后进行使用。
 
@@ -503,7 +544,7 @@ sidebar_position: 8
 
 3.2 转让
 
-通常情况下，除非获得用户的明确同意，我们不会将用户的个人信息转让给任何公司、组织和个人，但以下情况除外：  
+通常情况下，除非获得用户的明确同意，我们不会将用户的个人信息转让给任何公司、组织和个人，但以下情况除外：
 在涉及合并、收购、资产转让或类似的交易时，如涉及到个人信息转让，我们会要求新的持有用户个人信息的公司、组织以不低于本隐私政策所要求的标准继续保护用户的个人信息，否则，我们将要求该公司、组织重新向用户征求授权同意。
 
 3.3 披露
@@ -602,4 +643,10 @@ TapSDK 个人信息保护负责人邮箱：`[email protected]`
 
 我们将在 15 天内予以回复。
 
-<small>本页面内容具有多种语言版本，若其他语言版本与简体中文版本发生冲突，应以简体中文版本为准。</small>
+<small>本页面内容具有多种语言版本，若其他语言版本与简体中文版本发生冲突，应以简体中文版本为准。</small>
+
+
+
+
+
+
diff --git a/cn/docs/sdk/start/compliance.mdx b/cn/docs/sdk/start/compliance.mdx
@@ -406,6 +406,50 @@ public void onRequestPermissionsResult(int requestCode, String[] permissions, in
 
 无
 
+### 10. TapTap IAP
+
+- 功能介绍
+
+提供 TapTap IAP(In App Purchase) 能力，玩家可以通过 TapTap IAP 快速购买所需要的游戏道具，最终会通过微信支付、支付宝支付等方式完成支付。
+
+- 合规调用时机
+
+玩家触发游戏内道具购买时进行初始化和调用。
+
+- 需要权限
+
+| 权限 | 使用目的 | 权限申请时机 |
+| ---------------------- | ---------------------- | ---------------------- |
+| 网络权限 | 用于访问网络数据 | 用户首次使用该功能时会申请权限 |
+| 获取网络状态 | 用于检测当前网络连接是否有效 | 用户首次使用该功能时会申请权限 |
+
+- 关闭功能的配置方式
+
+若要关闭，可在app目录build.gradle中移除对该功能的依赖（详见[文档](https://developer.taptap.cn/docs/sdk/update/guide/#tapsdk-%E5%88%9D%E5%A7%8B%E5%8C%96)），示例如下：
+
+```
+// implementation("com.taptap.android.payment:iap:latest")
+// implementation("com.taptap.android.payment:base:latest")
+// implementation("com.taptap.android.payment:alipaycn:latest")
+// implementation("com.taptap.android.payment:wechat:latest")
+```
+
+- 必要个人信息
+
+| 必要个人信息 | 使用目的 | 场景 |   收集频次 |
+| ------ | ------ | ------ | ------ |
+| 系统版本 | 为了确保设备系统兼容、定位解决问题 | 遇到服务故障时针对性进行排查和优化 |  每次应用冷启动获取一次 |
+| 设备型号 | 为了确保设备系统兼容、定位解决问题 | 遇到服务故障时针对性进行排查和优化 |  每次应用冷启动获取一次 |
+| 设备 CPU 信息 | 为了确保设备系统兼容、定位解决问题 | 遇到服务故障时针对性进行排查和优化 |  每次应用冷启动获取一次 |
+| 网络类型 | 为了确保设备系统兼容、定位解决问题 | 遇到服务故障时针对性进行排查和优化 |  每次应用冷启动获取一次 |
+| Android ID | 为了确保设备系统兼容、定位解决问题 | 遇到服务故障时针对性进行排查和优化 |  初始化及用户发起授权时获取一次 |
+| 设备内存信息 | 为了确保设备系统兼容、定位解决问题 | 遇到服务故障时针对性进行排查和优化 |  每次应用冷启动获取一次 |
+| 手机样式 | 为了确保设备系统兼容、定位解决问题 | 遇到服务故障时针对性进行排查和优化 |  每次应用冷启动获取一次 |
+
+- 可选个人信息
+
+无
+
 
 ## **四、向最终用户披露 TapSDK 条款**
 

diff --git a/cn/docs/sdk/start/overview.mdx b/cn/docs/sdk/start/overview.mdx
@@ -52,6 +52,8 @@ TDS 提供以下技术服务，开发者可以通过在游戏中集成 TapSDK
 
 - **APK 加固**：避免游戏包体被破解篡改，保障游戏安全。
 
+- **内购服务**：TapTap 游戏内购服务为开发者提供了便捷高效的解决方案。接入该服务后，开发者可轻松开放游戏内购，无论是消耗型道具还是非消耗型道具，都能方便地上架售卖。同时，订单查看功能，让开发者对销售情况一目了然。
+
 </Conditional>
 
 使用对应的服务请先完成<Conditional region="cn">[开发者注册](https://developer.taptap.cn/)</Conditional><Conditional region="global">[开发者注册](https://developer.taptap.io/)</Conditional>，之后登录开发者中心开启「游戏服务」。
diff --git a/cn/docs/sdk/start/release-notes/android.mdx b/cn/docs/sdk/start/release-notes/android.mdx
@@ -3,6 +3,25 @@ title: Android
 sidebar_position: 2
 ---
 
+<h2> 4.5.0 </h2>
+
+更新时间 2024-11-18
+
+<h4> 功能 </h4>
+
+- 新增 [ 内购服务 ] ：提供整合商品管理、支付渠道、订单管理的便捷内购解决方案
+
+<h4> 优化 </h4>
+
+- 合规认证：当 Startup 接口异步处理未结束时，如果重复调用该接口，SDK 将直接返回
+- 删除冗余 Protobuf 依赖
+
+
+<h4> 修复 </h4>
+
+- 修复 OAID 参数设置无效问题
+
+
 <h2> 4.4.3 </h2>
 
 更新时间 2024-10-30

diff --git a/cn/docs/sdk/start/release-notes/ios.mdx b/cn/docs/sdk/start/release-notes/ios.mdx
@@ -3,6 +3,21 @@ title: iOS
 sidebar_position: 3
 ---
 
+<h2> 4.5.0 </h2>
+
+更新时间 2024-11-18
+
+<h4> 优化 </h4>
+
+- 合规认证：当 Startup 接口异步处理未结束时，如果重复调用该接口，SDK 将直接返回
+- 内嵌动态：添加隐私说明文件，删除在 framework 中冗余的资源文件
+
+<h4> 修复 </h4>
+
+- 合规认证：修复使用原生接入时编译异常
+- 内嵌动态：修复使用原生接入时编译异常
+
+
 <h2> 4.4.3 </h2>
 
 更新时间 2024-10-30

diff --git a/cn/docs/sdk/start/release-notes/unity.mdx b/cn/docs/sdk/start/release-notes/unity.mdx
@@ -3,6 +3,27 @@ title: Unity
 sidebar_position: 1
 ---
 
+<h2> 4.5.0 </h2>
+
+更新时间 2024-11-18
+
+<h4> 功能 </h4>
+
+- [Android] 新增 [ 内购服务 ] ：提供整合商品管理、支付渠道、订单管理的便捷内购解决方案
+
+
+<h4> 优化 </h4>
+
+- 合规认证：当 Startup 接口异步处理未结束时，如果重复调用该接口，SDK 将直接返回
+- 删除冗余 Protobuf 依赖
+- [iOS] 内嵌动态：添加隐私说明文件，删除在 framework 中冗余的资源文件
+- [PC] TapTap 登录：更新内部网络库及登录页面扫码引导图
+
+<h4> 修复 </h4>
+
+- [Android] 修复 OAID 参数设置无效问题
+- [Android] 数据分析：修复调用仅包含用户 ID 的 SetUserID 接口时的异常问题
+
 <h2> 4.4.3 </h2>
 
 更新时间 2024-10-30

diff --git a/cn/docs/sdk/tap-iap/_category_.json b/cn/docs/sdk/tap-iap/_category_.json
@@ -0,0 +1,5 @@
+{
+  "label": "内购服务",
+  "collapsed": true,
+  "position": 16
+}