跳到主要内容
版本：v4

PC C++ SDK 接入概览

产品介绍​

TapSDK PC 版是专为通过 TapTap 启动器运行的 PC 游戏设计的 C++ SDK。 它提供了与 TapTap 平台深度集成的功能，包括用户授权、正版验证（买断制游戏）等基础功能，与及云存档等扩展功能。

基础功能​

启动校验​

  • 游戏所有权验证：验证用户是否拥有游戏

登录​

  • TapTap 登录授权：获取用户授权
  • 用户信息获取：获取用户 OpenID 等基础信息

正版验证（买断制游戏）​

  • DLC 所有权验证：检查用户是否拥有特定 DLC
  • DLC 商店展示：引导用户购买 DLC
  • 游戏、DLC 状态监控：监听游戏和 DLC 的可玩状态变化

扩展功能​

云存档​

  • 存档保存到 TapTap 云端：玩家可从任意设备读取存档继续游戏，避免因存档丢失导致玩家流失。

环境要求​

  • 操作系统：Windows 7 或更高版本的 64 位操作系统
  • 运行环境：游戏必须通过 TapTap 启动器启动
  • 网络要求：需要网络连接
  • SDK 类型：动态链接库（DLL）

集成准备​

1. 获取开发者资源​

在开始集成前，您需要：

  1. 在TapTap 开发者中心注册开发者账号
  2. 创建游戏应用并在「你的游戏」→「游戏服务」→「应用配置」获取以下信息：
    • Client ID：应用的唯一标识符
    • Client Public Key：用于 SDK 初始化的公钥字符串

2. 下载 SDK​

访问 TapSDK PC C++ Releases 页面下载最新版本的 SDK。

SDK 包含以下文件：

  • taptap_api.h：初始化、注册回调、用户授权、正版验证等基础功能 API 头文件
  • taptap_cloudsave.h：云存档功能 API 头文件
  • taptap_api.dll：动态库文件（Windows）
  • taptap_api.lib：导入库文件（Windows）

基本集成步骤​

语言支持说明​

PC SDK 以动态链接库（DLL）形式提供，支持多种编程语言集成：

  • C++
    • 如果只需要用户授权、正版验证等基础功能，请包含头文件taptap_api.h。具体集成方式，请参考快速开始。
    • 如果需要使用云存档功能，请包含头文件taptap_cloudsave.h。具体集成方式，请参考云存档快速接入。
  • 其他语言：通过各自语言的 DLL 调用机制实现。

添加 SDK 文件​

将下载的 SDK 文件添加到您的项目中：

C++ 项目：

#include "taptap_api.h" // 必须包含基础功能头文件
#include "taptap_cloudsave.h" // 如果需要云存档功能

其他语言：

  • 将 taptap_api.dll 放置在可执行文件同目录或系统路径中
  • 根据语言特性加载 DLL 并声明函数签名

文档结构​

本文档包含以下内容：

  1. 基础功能：SDK 基础功能集成、基础配置，与及详细 API 文档和使用示例
  2. 云存档：云存档功能集成、详细 API 文档和使用示例

开始使用前，请先阅读快速开始了解集成流程。