Before you begin

Before you can use it, you need to:

1. Create a Game inside the Fireball Admin panel
2. Create Game Function
3. Create Game Client

Authorization request

1. Parse incoming json message in Function script

    [FunctionsStartup(typeof(Startup))]
    public class Function : ICloudEventFunction<MessagePublishedData>
    {
        ...

        public async Task HandleAsync(CloudEvent cloudEvent, MessagePublishedData data, CancellationToken cancellationToken)
        {
            string messageJson = data.Message?.TextData;
            ParseResult result = await _fireball.ParseMessage(messageJson);
            MessageResult messageResult = await _game.HandleMessage(result);
        }
    }

2. Receiving authorization message from client and send auth request to appropriate operator integration in the Game script:

        public async Task<MessageResult> HandleMessage(ParseResult result)
        {
            if (result.IsSuccess)
            {
                switch (result.MessageName)
                {
                    case FireballConstants.MessagesNames.AUTHENTICATE:
                        return await Auth(result.ToMessage<AuthMessage>());

                    default:
                        return MessageResult.ErrorResult($"Undefined message name: {result.MessageName}");
                }
            }

            return MessageResult.ErrorResult("Error Parse message...");
        }

        ...

        private async Task<MessageResult> Auth(AuthMessage message)
        {
            _logger.Log($"authenticate: {message.ToJson()}");

            // send the authenticating message
            return await _fireball.Authenticate(message);
        }

3. Receiving session message from operator's integration as a result of successful authorization:

        public async Task<MessageResult> HandleMessage(ParseResult result)
        {
            if (result.IsSuccess)
            {
                switch (result.MessageName)
                {
                    ...

                    case FireballConstants.MessagesNames.SESSION:
                        return await OnAuthSuccess(result.ToMessage<SessionMessage>());

                    ...
                }
            }

            ...
        }

4. Check for Game Session and send session message to the Game client:

        private async Task<MessageResult> OnAuthSuccess(SessionMessage message)
        {
            if (message.GameSession == null)
            {
                // create a new game session
            }
            return await _fireball.SendSessionToClient(message);
        }

More information about creating and managing game sessions check here

Authorization Reject

1. Receiving authorization reject message from operator's integration as a result of failed to authorize:

        public async Task<MessageResult> HandleMessage(ParseResult result)
        {
            if (result.IsSuccess)
            {
                switch (result.MessageName)
                {
                    ...

                    case FireballConstants.MessagesNames.AUTHENTICATE_REJECT:
                        return await OnAuthReject(result.ToMessage<ErrorMessage>());

                    ...
                }
            }

            ...
        }

2. Sending authorization error to client:

        private async Task<MessageResult> OnAuthReject(ErrorMessage error)
        {
            return await _fireball.SendErrorToClient(error, ErrorCode.Authentication);
        }

Next Steps

• Deploy Game Function
• Manage Game Session and game state
• Messaging with Game client
• Check Sample Project