StovePCMatchmaking(Native dll): Matchmaking SDK

StovePCMatchmaking(Native dll) 1.0.4.1

- Main Page
- Modules
- Classes
- Files
- Examples

Matchmaking SDK

# Matchmaking system

- A system that gathers users into a single location (lobby) so that they can play the game together.

## Introduction

- Matchmaking Client is provided in SDK form and is used by calling the SDK directly from the game client.
- Add metadata to the lobby and use it as search data.
- You can import your data from the Stat System or rankings and add it to the lobby as metadata.
- Users search for lobbies and enter the desired lobby according to the conditions.
- You can invite other users to the lobby you joined.
- Supports data broadcasting or chatting within the lobby.

## Provided file

This is a native dll written in c/c++.
StovePCMatchmaking.dll can be used in C#/Unity, etc. by dllimport(pinvoke).

- Header files
  - StovePCMatchmakingSDK.h
  - StovePCMatchmakingCallback.h
  - StovePCMatchmakingDefine.h
- Binary files (for 32/64 bit)
  - StovePCMatchmaking64.lib
  - StovePCMatchmaking64.dll

## Introduction to key features

1. Connect to a matchmaking server
   - You can register your game with the matchmaking server through the Game Services>Matchmaking menu on STOVE Studio, and develop game user matching with the Matchmaking Client SDK.
   - StovePCMatchmaking_Connect Connect to the matchmaking server.
2. Create a lobby
   - StovePCMatchmaking_CreateLobby Create a lobby.
   - Enter a title for the lobby you want to create.
3. Lobby metadata
   - StovePCMatchmaking_SetLobbyData You can add / edit metadata to your lobby.
     1. The metadata you add will be utilized when searching for lobbies.
   - StovePCMatchmaking_GetLobbyData You can view the lobby metadata.
4. Lobby search
   - StovePCMatchmaking_RequestLobbyList You can search for lobbies.
     1. StovePCMatchmaking_AddRequestLobbyListFilter You can add search criteria.
     2. Searches the entire lobby when there are no search criteria.
   - StovePCMatchmaking_AddRequestLobbyListFilter Add lobby search criteria.
     1. It can be called nested, and each nest is appended to the preceding search criteria as an AND operation.
     2. StovePCMatchmaking_RequestLobbyList After the call, the lobby search conditions are initialized.
     3. 예시 :
        1. StovePCMatchmaking_AddRequestLobbyListFilter("map", "1", "=");
        2. StovePCMatchmaking_AddRequestLobbyListFilter("mode", "2", "=");
        3. StovePCMatchmaking_RequestLobbyList();
        4. "map = 1 and mode = 2" Request a lobby search
5. Lobby Entry / Random Entry
   - StovePCMatchmaking_JoinLobby Enter a lobby name to join.
   - StovePCMatchmaking_JoinRandomLobby Enter search criteria to join the lobby.
     - You will automatically join one of the lobbies that match your search criteria.
     - Automatically creates a lobby if no lobbies match the search criteria.
6. User metadata
   - Each user is assigned a metadata store upon entering the lobby.
   - StovePCMatchmaking_SetLobbyUserdata I can add/edit my metadata.
     - Your added/edited user data will be broadcast to all users in the lobby.
   - StovePCMatchmaking_GetLobbyUserList View information and metadata for all users in your lobby.
     - Returns a list of users in the order they entered the lobby.
7. Sending data in the lobby
   - StovePCMatchmaking_SendLobbyBinarydata You can send binary data to users in the lobby.
8. Send in-lobby messages
   - StovePCMatchmaking_SendLobbyMsg You can send a message to any user in the lobby.
9. Getting callbacks
   - Call the callback function received from the server.
   - StovePCMatchmaking_RunCallback The callback function is not called until it is called.