// Invoked on success/failure
public delegate void OnMatch(Result result, MatchResponse match);

// The data for every player returned by the matchmaking request
public struct PlayerPayload
{
    public string user_id;
    public string team;
    public int score;
    public string payload;
}

// The response of the matchmaking request
public class MatchResponse
{
    public string match_id;
    public PlayerPayload[] players;
    public string error;
}

public static class Matchmaker
{
    // Sends matchmaking request.
    // region:  matchmaking region, e.g. eu, us, ...
    // team:    team name
    // payload: custom string that will be send to all other players
    public static void Match(string region, string team, string payload, OnMatch callback)
    
    // Sends a matchmaking request
    // region:  matchmaking region, e.g. eu, us, ...
    // team:    team name
    // payload: custom string that will be send to all other players
    // tags:    custom tags to segment the player pool, e.g. "level1", "qa", etc
    // friends: group the player with his friends. If any of the friends doesn't show up the request will fail
    public static void Match(string region, string team, string payload, string[] tags, string[] friends, OnMatch callback)
}

Matchmaker.Match("eu", "blue", "car:volvo,rifle:glock", (res, match) => {
    if (res == Result.Timeout) {
        // timed out, inform the player
        return
    }
    
    // match.players contain all the matched players and their data
    // including the this player
}

public static class Play
{
    // Initialises the Cloud API
    public static void Init(string RuntimeKey)
}

public static class Auth
{
    public enum Result
    {
        // Successful operation.
        Success,
        
        // Network error, e.g. connection failed.
        NetworkError,
        
        // Server error, e.g. exception on the server.
        ServerError,
        
        // User not found, e.g. when trying to login with non-existing user
        UserNotFound,
        
        // Invalid credentials, e.g. when trying to login with wrong password
        InvalidCredentials,
        
        // Session has expired, e.g. when trying to renew an existing session
        SessionExpired,
        
        // Feature is not enabled, e.g. K/V store
        FeatureDisabled,
    }
       
    // Invoked when completing the login process.
    public delegate void OnSession(Result result);
}

public static class Auth
{
    // Authenticates the players as a guest.
    // callback - invoked upon completion.
    public static void LoginAsGuest(OnSession callback)
}

public static class Auth
{
    // Authenticates the player with a username and a password.
    // userName   - any combination of letters, numbers, underscore and dash.
    // password   - any combination of ASCII characters
    // autosignup - whether to create an account automatically if it
    //              doesn't exist and the username is not taken
    // callback   - invoked upon completion
    public static void LoginAsUser(string userName, string password,
        bool autosignup, OnSession callback)
}

using Play = Coherence.Runtime;

void OnLogin()
{
    Debug.Log(string.Format("Logged in. PlayerId={0}", Play.Auth.UserId));
}

void Start()
{
    // Initialise the Cloud API
    Play.Play.Init(apiToken);
    
    // Check for existing session
    Play.Auth.IsLoggedIn((res) => {
        if (res == Play.Result.Success)
        {
            // Session resumed
            OnLogin();
        }
        else if (res == Play.Result.SessionExpired || res == Play.Result.UserNotFound)
        {
            // No session found, or session expired. Proceed with normal login.
            Play.Auth.LoginAsGuest((res2) =>
            {
                if (res2 == Play.Result.Success)
                {
                    OnLogin();
                    return;
                }
                UnityEngine.Debug.LogError(string.Format("Could not login. Error={0}", res2));
            });
        }
        else
        {
            UnityEngine.Debug.LogError(string.Format("Could not login. Error={0}", res));
        }
    });
}