Skip to content

Commit

Permalink
V3 升级到 V4 的说明 (#1258)
Browse files Browse the repository at this point in the history
* 添加 V3升级V4的说明文档

* 新增 V3 升级 V4 的说明

* Update cn/docs/sdk/access/v3-to-v4.mdx

Co-authored-by: XXu <284898541@qq.com>

* Update cn/docs/sdk/access/v3-to-v4.mdx

Co-authored-by: XXu <284898541@qq.com>

* Update cn/docs/sdk/access/v3-to-v4.mdx

Co-authored-by: XXu <284898541@qq.com>

* 统一字母大小写

* 修改内容

---------

Co-authored-by: 余文建 <8997665+yu_wenjian@user.noreply.gitee.com>
Co-authored-by: XXu <284898541@qq.com>
  • Loading branch information
3 people authored Nov 8, 2024
1 parent 55f7591 commit fe6f410
Showing 1 changed file with 58 additions and 0 deletions.
58 changes: 58 additions & 0 deletions cn/docs/sdk/access/v3-to-v4.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,58 @@
---
title: SDK v3 升级 v4 的说明
sidebar_label: v3 升级 v4
sidebar_position: 4
---

import MultiLang from "/src/docComponents/MultiLang";
import CodeBlock from "@theme/CodeBlock";
import { Conditional } from "/src/docComponents/conditional";

本文介绍 v3(3.X) 版本 SDK 如何升级到 v4(4.X) 版本。

## 说明

2024 年 8 月 30 日,我们上线了 v4 版本 SDK,同时更新了开发者中心控制台,新创建的游戏应用默认是 v4 版本应用。新应用请配套使用 v4.3.10 及以上版本 TapSDK,文档请参考 [**v4 版本 TapSDK 文档**](https://developer.taptap.cn/docs/sdk/access/quickstart/)

此前创建的应用为 v3 版本,可以继续使用 v3 版本 TapSDK,参考 [**v3 版本 TapSDK 文档**](https://developer.taptap.cn/docs/v3/sdk/start/quickstart/)进行集成。相关服务仍将可用。对于符合条件的 v3 应用想要升级使用 v4 版本 SDK,也可通过工单申请,申请通过并升级完成后可以参考 [**v4 版本 TapSDK 文档**](https://developer.taptap.cn/docs/sdk/access/quickstart/)进行集成。

:::tip
- 新版 v4 服务不再包含内建账户(同时取消了域名绑定功能)、云引擎、数据存储、多人在线对战、悬浮窗相关功能。
- 好友、支付、排行榜、云存档,及更多新功能,都将在以后陆续上线,敬请期待。
:::


## 如何判断开发者后台应用是 v3 还是 v4 版本

可以通过开发者后台游戏服务页面的样式布局进行判断,两个版本后台的样式分别如下图:

- v4 应用游戏服务页面样式:

![v4-后台样式](https://img.tapimg.com/market/images/f0528b0e56e7edc90a357f3d4c85fc47.png)

- v3 应用游戏服务页面样式:

![v3-后台样式](https://img.tapimg.com/market/images/a2d7836b576bc3da0c8bd806991f3a7a.png)


## v3 应用升级使用 v4 版本 SDK 的条件

1. 之前未使用内建账户、云存档、成就、排行榜、数据存储、悬浮窗、游戏好友、云引擎、多人在线对战、TapTap 好友、自定义域名、客服系统的情况下可以申请升级。
2. 如果之前使用了内建账户等云服务并产生了数据,但是以后不需要这些数据和服务的情况下,可以自行清空后台这些数据并解绑自定义域名,然后可以申请升级。

## 当 v3 版本应用集成 v4 版本 SDK 的异常现象

1. 执行初始化代码后,控制台会打印如下图中日志:

![](https://img.tapimg.com/market/images/dcbcb94d7382915eda03d0ef7f4b0cdb.png)

2. 执行初始化代码后,应用会弹出如下图中的提示:

![](https://img.tapimg.com/market/images/05b64e71abb7832648f6e1f38626ba21.jpg)


当出现以上情况表示你的应用版本和集成的 SDK 版本不匹配,有以下两种方案:

1. 继续使用 v3 版本 SDK;

2. 参考[v3 应用升级使用 v4 版本 SDK 的条件](/sdk/access/v3-to-v4/#v3-应用升级使用-v4-版本-sdk-的条件)说明,自行评估是否需要升级到 v4 版本,当确认升级时,请通过工单进行申请(工单中请告知应用 Client id)。

0 comments on commit fe6f410

Please sign in to comment.