Skip to main content
Version: v4

PC C++ SDK Integration Overview

Product Introduction​

TapSDK PC is a C++ SDK specifically designed for PC games running through the TapTap launcher. It provides deep integration with the TapTap platform, including basic features such as user authorization, license verification (for premium games), and consistent random number generation, as well as extended features such as cloud save, online multiplayer and achievement.

Basic Features​

Launch Verification​

  • Game Ownership Verification: Verify whether the user owns the game

Login​

  • TapTap Login Authorization: Get user authorization
  • User Information Retrieval: Get basic user information such as OpenID

License Verification (Premium Games)​

  • DLC Ownership Verification: Check if the user owns specific DLC
  • DLC Store Display: Guide users to purchase DLC
  • Game and DLC Status Monitoring: Monitor changes in the playable status of games and DLC

Consistent Random Number​

  • Cross-device consistent random number: Ensures the same random number sequence is generated when the application runs on different devices

Extended Features​

Cloud Save​

  • Save to TapTap Cloud: Players can read saves from any device to continue their game, avoiding player churn due to save loss.

Online Multiplayer​

  • Room management: Create rooms, auto-match, and join specific rooms, with full in-room player management.
  • Player communication: Players in a room can send and receive messages, with person to person and broadcast support. You can build state-sync games on top of this.
  • Advanced Feature: For real-time competitive games, the SDK provides frame sync at 30 FPS.

Achievement​

  • Achievement unlocking: Supports direct unlock for standard achievements and step-based incremental unlocking for incremental achievements.
  • Achievement display: Open an achievements page in the TapTap where players can view achievements and completion status.

System Requirements​

  • Operating System: Windows 7 or higher, 64-bit
  • Runtime Environment: Games must be launched through the TapTap launcher
  • Network Requirements: Internet connection required
  • SDK Type: Dynamic Link Library (DLL)

Integration Preparation​

1. Get Developer Resources​

Before starting integration, you need to:

  1. Register a developer account at TapTap Developer Center
  2. Create a game application and obtain the following information from "Your Games" → "Game Services" → "Application Configuration":
    • Client ID: Unique identifier for the application
    • Client Public Key: Public key string for SDK initialization

2. Download SDK​

Visit the TapSDK PC C++ Releases page to download the latest version of the SDK.

The SDK includes the following files:

  • taptap_api.h: Header file for basic features API (initialization, callback registration, user authorization, license verification, consistent random number, etc.)
  • taptap_achievement.h: Header file for achievement feature API
  • taptap_cloudsave.h: Header file for cloud save feature API
  • taptap_onlinegame.h: Header file for online multiplayer feature API
  • taptap_api.dll: Dynamic library file (Windows)
  • taptap_api.lib: Import library file (Windows)

Basic Integration Steps​

Language Support​

The PC SDK is provided as a Dynamic Link Library (DLL) and supports integration with multiple programming languages:

  • C++
    • If you only need basic features such as user authorization, license verification, and consistent random number, include the header file taptap_api.h. For specific integration steps, refer to Quick Start.
    • If you need to use cloud save features, include the header file taptap_cloudsave.h. For specific integration steps, refer to Cloud Save Quick Start.
    • If you need to use online multiplayer features, include the header file taptap_onlinegame.h. For specific integration steps, refer to Online Multiplayer Quick Start.
    • If you need to use achievement features, include the header file taptap_achievement.h. For specific integration steps, refer to Achievement Quick Start.
  • Other Languages: Implement through each language's DLL calling mechanism.

Add SDK Files​

Add the downloaded SDK files to your project:

C++ Project:

#include "taptap_api.h" // Must include basic features header file
#include "taptap_achievement.h" // If achievement features are needed
#include "taptap_cloudsave.h" // If cloud save features are needed
#include "taptap_onlinegame.h" // If online multiplayer features are needed

Other Languages:

  • Place taptap_api.dll in the same directory as the executable or in the system path
  • Load the DLL and declare function signatures according to language-specific features

Documentation Structure​

This documentation contains the following content:

  1. Basic Features: SDK basic features integration, basic configuration, detailed API documentation, and usage examples
  2. Cloud Save: Cloud save feature integration, detailed API documentation, and usage examples
  3. Online Multiplayer: Online multiplayer feature integration, detailed API documentation, and usage examples
  4. Achievement: Achievement feature integration, detailed API documentation, and usage examples

Before getting started, please read Quick Start to understand the integration process.