Trail C SDK

This is the Trail native SDK reference documentation, the libraries and headers are available for download in the game manager.

What's available in the package:

include/
    trail.h         # Header file with the definition of all our functions and structs
lib/
    trailsdk.bundle # Lib for developing on OSX
    libtrailsdk.bc  # Emscripten lib compiled with emcc 2.0.16
    libtrailsdk.so  # Linux shared object
    trailsdk.dll    # Windows dll

Example

#include <trail.h>
 
Trail* trail_sdk;
TrailDestroy trail_destroy;
 
const char* cloud_storage_path;
 
const char* username = "anon";
 
void sync_cloud_storage_cb(TrailResult res, void *data) {}
 
void init_cb(TrailResult res, Trail* sdk, TrailDestroy destroy, void* data) {
    /* Try to verify the result of Trail's methods */
    if (res != TRAIL_RESULT_OK) {
        fprintf(stderr, "Error while initalising Trail SDK: %d\n", res);
        exit(EXIT_FAILURE);
    }
    trail_sdk = sdk;
    /* This function should be call when you exit the game to terminate the sdk before */
    trail_destroy = destroy;
 
    /* Stop the loading spin and actually start the game */
    trail_sdk->core->report_game_loaded();
 
    /* Retrieve username of the player */
    trail_sdk->auth_kit->get_username(&username);
 
    /* Retrieve the folder path where you can save your files */
    trail_sdk->file_kit->get_cloud_storage_path(&cloud_storage_path);
    char* file_path;
    asprintf(&file_path, "%s/%s", cloud_storage_path, "my_save");
    FILE *save = fopen(file_path, "w+");
    fprintf(save,"level:%d", 7);
    fclose(save);
    /* Sync your files in the cloud storage folder */
    trail_sdk->file_kit->sync_cloud_storage(sync_cloud_storage_cb, NULL);
}
 
int main() {
    /* Address of the runnnig CLI for developement, not needed for emscripten build */
    char dev_host[] = "127.0.0.1:23000\0";
 
    TrailInitParams params = {nullptr, 0};
    strncpy((char*)params.dev_host, dev_host, sizeof(dev_host));
 
    /* Init the sdk, this is a blocking call in non EMSCRIPTEN builds */
    trail_init(&params, init_cb, NULL);
 
    while (true) {
        /* Your game */
        /* [...] */
    }
 
    /* Terminate the trail SDK */
    trail_destroy(trail);
 
 
    return 0;
}