版本：v4

PC C++ SDK 接入概览

产品介绍

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

基础功能

启动校验

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

正版验证（买断制游戏）

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

一致性随机数

跨设备一致性随机数：确保在不同设备上运行应用时，生成相同的随机数序列

扩展功能

云存档

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

多人联机

房间管理：支持创建房间、自动匹配和加入指定房间，提供完善的房间内玩家管理功能。
玩家通信：房间内玩家之间可以自由发送和接收消息，支持点对点通信和广播。开发者可以基于此开发状态同步游戏。
高级特性：针对高实时性竞技游戏，SDK 还提供了帧同步功能，帧率 30 FPS。

成就

成就解锁：支持普通成就直接解锁，以及分步成就按步长累加解锁。
成就展示：在 TapTap 内打开成就展示页，玩家可查看成就及达成情况。

环境要求

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

集成准备

1. 获取开发者资源

在开始集成前，您需要：

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

2. 下载 SDK

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

SDK 包含以下文件：

taptap_api.h：初始化、注册回调、用户授权、正版验证、一致性随机数等基础功能 API 头文件
taptap_achievement.h：成就功能 API 头文件
taptap_cloudsave.h：云存档功能 API 头文件
taptap_onlinegame.h：多人联机功能 API 头文件
taptap_api.dll：动态库文件（Windows）
taptap_api.lib：导入库文件（Windows）

基本集成步骤

语言支持说明

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

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

添加 SDK 文件

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

C++ 项目：

#include "taptap_api.h" // 必须包含基础功能头文件
#include "taptap_achievement.h" // 如果需要成就功能
#include "taptap_cloudsave.h" // 如果需要云存档功能
#include "taptap_onlinegame.h" // 如果需要多人联机功能

其他语言：

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

文档结构

本文档包含以下内容：

基础功能：SDK 基础功能集成、基础配置，与及详细 API 文档和使用示例
云存档：云存档功能集成、详细 API 文档和使用示例
多人联机：多人联机功能集成、详细 API 文档和使用示例
成就：成就功能集成、详细 API 文档和使用示例

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

产品介绍​

基础功能​

启动校验​

登录​

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

一致性随机数​

扩展功能​

云存档​

多人联机​

成就​

环境要求​

集成准备​

1. 获取开发者资源​

2. 下载 SDK​

基本集成步骤​

语言支持说明​

添加 SDK 文件​

文档结构​