Configuration

Android

Configure TMAuthentication first, then TMTickets. Also make sure your activity extends SessionExpiredHandler so that you can handle Session Expired errors (usually by logging out the user).

Example Kotlin code:

class MainActivity : SessionExpiredHandler {

    override fun onSessionExpired() {
        TicketsSDKSingleton.logout(this) {
            // This will be your own logic
            onLogout()
        }
    }

    // Do this wherever you need to start Auth and Tickets SDK
    fun setupAuthAndTicketsSDK() {
        authentication = TMAuthentication.Builder()
            .apiKey(consumer_key)
            .clientName(client_name) // Team name to be displayed
            .colors(createTMAuthenticationColors(brandingColor))
            .environment(TMXDeploymentEnvironment.Production) // Environment that the SDK will use. Default is Production
            .region(TMXDeploymentRegion.US) // Region that the SDK will use. Default is US
            .build(activity)

        TicketsSDKClient
            .Builder()
            .authenticationSDKClient(authentication) //Authentication object
            //Optional value to define the colors for the Tickets page
            .colors(TicketsColors(LightColorPalette, DarkColorPalette))
            //Function that generates a TicketsSDKClient object
            .build(Activity)
            .apply {
                //After creating the TicketsSDKClient object, add it into the TicketsSDKSingleton
                TicketsSDKSingleton.setTicketsSdkClient(this)
        }
    }

    private fun createTMAuthenticationColors(color: Int):    TMAuthentication.ColorTheme =
        TMAuthentication.ColorTheme(
        // The Color class is part of the Compose library
            lightColors(
                primary = Color(color),
                primaryVariant = Color(color),
                secondary = Color(color),
                onPrimary = Color.White // Color used for text and icons displayed on top of the primary color.
            ),
            darkColors(
                primary = Color(color),
                primaryVariant = Color(color),
                secondary = Color(color),
                onPrimary = Color.White // Color used for text and icons displayed on top of the primary color.
            )
        )

iOS

Configure TMAuthentication first, then TMTickets.

Example Swift code:

import Foundation
import TicketmasterAuthentication
import TicketmasterTickets

class Example: NSObject {

    func configure() {
        // build a combination of Settings and Branding
        let tmxServiceSettings = TMAuthentication.TMXSettings(apiKey: "12345",
                                                              region: .US)
        
        let branding = TMAuthentication.Branding(displayName: "My Team",
                                                 backgroundColor: .red,
                                                 theme: .light)
        
        let brandedServiceSettings = TMAuthentication.BrandedServiceSettings(tmxSettings: tmxServiceSettings,
                                                                             branding: branding)
        
        // configure TMAuthentication with Settings and Branding
        print("Authentication SDK Configuring...")
        TMAuthentication.shared.configure(brandedServiceSettings: brandedServiceSettings) { backendsConfigured in
            // your API key may contain configurations for multiple backend services
            // the details are not needed for most common use-cases
            print(" - Authentication SDK Configured: \(backendsConfigured.count)")
            
            // TMTickets inherits it's configuration and branding from TMAuthentication
            print("Tickets SDK Configuring...")
            TMTickets.shared.configure {
                // Tickets is configured, now we are ready to present TMTicketsViewController or TMTicketsView
                print(" - Tickets SDK Configured")
                
            } failure: { error in
                // something went wrong, probably TMAuthentication was not configured correctly
                print(" - Tickets SDK Configuration Error: \(error.localizedDescription)")
            }
            
        } failure: { error in
            // something went wrong, probably the wrong apiKey+region combination
            print(" - Authentication SDK Configuration Error: \(error.localizedDescription)")
        }
    }
}

Important Note

Many Apps use a single API Key because the App only supports a single Team, Artist, or Venue.
However, you may want your App to support multiple API keys (for example a Venue App with multiple Home Teams, or an App that covers many Team in the league).
If so, you must enable ephemeral browsing for login.
see Switching Teams without Logging Out