Seats.io Android SDK

Introduction

seatsio-android allows rendering seats.io seating charts or the event manager inside an Android application.

Android SDK version 29 and upwards is supported (which corresponds to Android 10)

Installation

Adding the seatsio-android dependency

seatsio-android is available in the Maven Central repository:

// build.gradle
dependencies {
  compile 'io.seats:seatsio-android:16.4.0'
}

// pom.xml
<dependency>
  <groupId>io.seats</groupId>
  <artifactId>seatsio-android</artifactId>
  <version>16.4.0</version>
</dependency>

Note that v12.0.0 is the first version that's hosted on Maven Central instead of on JitPack.

Giving your app permission to access the internet

seatsio-android offers 2 custom views: SeatingChartView and EventManagerView. Those are WebViews, which need internet access. Make sure you add the following permission to AndroidManifest.xml

<manifest ...>

    <uses-permission android:name="android.permission.INTERNET" />

</manifest>

Setting a targetCompatibility of at least 1.8

Your build.gradle also needs to specify a targetCompatibility of 1.8 or higher:

android {
    compileOptions {
        targetCompatibility 1.8
    }
}

Examples

Regular charts

All configuration parameters are documented at https://docs.seats.io/docs/renderer-embed-a-floor-plan

Minimal

// this code should be inside an Activity
@Override
protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);
  SeatingChartConfig config = new SeatingChartConfig()
    .setWorkspaceKey("<yourPublicWorkspaceKey>")
    .setEvent("<yourEventKey>");
      
  setContentView(new SeatingChartView(Region.EU, config, getApplicationContext()));
}

Simple pricing

SeatingChartConfig config = new SeatingChartConfig()
  .setWorkspaceKey("<yourPublicWorkspaceKey>")
  .setEvent("<yourEventKey>")
  .setPricing(
          new Pricing(List.of(
                new PricingForCategory("Ground Floor", new SimplePricing(34)),
                new PricingForCategory("Balcony", new SimplePricing(50))
            ))
            .setPriceFormatter(price -> price + "€")
  );
  
setContentView(new SeatingChartView(Region.EU, config, getApplicationContext()));

Complex pricing

SeatingChartConfig config = new SeatingChartConfig()
  .setWorkspaceKey("<yourPublicWorkspaceKey>")
  .setEvent("<yourEventKey>")
  .setPricing(new Pricing(List.of(
          new PricingForCategory("13", new SimplePrice(80f, 120f)),
          new PricingForCategory("10", new TicketTypesPrice(
                  new TicketTypePricing(20.0f, "child").setOriginalPrice(25f),
                  new TicketTypePricing(30.5f, "adult").setOriginalPrice(35f))),
          new PricingForCategory("11", new TicketTypesPrice(
                  new TicketTypePricing(20.0f, "child"),
                  new TicketTypePricing(30.5f, "adult"))
          ),
          new PricingForChart(new ObjectPrice(List.of("VIP SEATS-A-1", "VIP SEATS-A-2", "VIP SEATS-A-3"), 54f, 76f)),
          new PricingForChart(new ObjectPrice(List.of("VIP SEATS-B-1", "VIP SEATS-B-2", "VIP SEATS-B-3"), List.of(
                  new TicketTypePricing(20.0f, "child"),
                  new TicketTypePricing(30.5f, "adult")
          ))),
          new PricingForCategory("13", new ChannelPrice(List.of(
                  new ChannelPricing("d0b3e5e6-5089-1cfa-2e1b-4123a544051e", 55f)
          ), 50f, 60f))))
          .setPriceFormatter((price) -> "€" + priceFormat.format(price))
          .setAllFeesIncluded(true)
  );
  
setContentView(new SeatingChartView(Region.EU, config, getApplicationContext()));

SeatingChartConfig config = new SeatingChartConfig()
  .setWorkspaceKey("<yourPublicWorkspaceKey>")
  .setEvent("<yourEventKey>");
  .setPricing(new Pricing(List.of(
      new PricingForCategory("Ground Floor",
          new TicketTypesPricing(
                      new TicketTypePricing(40, "Child"),
        new TicketTypePricing(50, "Adult")
      )),
              new PricingForCategory("Balcony",
                                             new TicketTypesPricing(
                                             new TicketTypePricing(60, "Child"),
        new TicketTypePricing(70, "Adult")
   ))
     ))
    .setPriceFormatter(price -> price + "€"));
  
setContentView(new SeatingChartView(Region.EU, config, getApplicationContext()));

Creating a session to hold seats

SeatingChartConfig config = new SeatingChartConfig()
  .setWorkspaceKey("<yourPublicWorkspaceKey>")
  .setEvent("<yourEventKey>")
  .setSession(START)
  .setOnChartRendered((chart) -> {
    chart.getHoldToken(holdToken -> {
      // do something with the hold token
    })
  });
SeatingChartView chart = new SeatingChartView(Region.EU, config, getApplicationContext())
        
setContentView(chart);

Handling object selections and deselections

SeatingChartConfig config = new SeatingChartConfig()
  .setWorkspaceKey("<yourPublicWorkspaceKey>")
  .setEvent("<yourEventKey>")
  .setOnObjectSelected((object, ticketType) -> /* do something */)
  .setOnObjectDeselected((object, ticketType) -> /* do something */);

setContentView(new SeatingChartView(Region.EU, config, getApplicationContext()));

chart.listSelectedObjects()

SeatingChartConfig config = new SeatingChartConfig()
  .setWorkspaceKey("<yourPublicWorkspaceKey>")
  .setEvent("<yourEventKey>")
  .setOnChartRendered((chart) -> {
    chart.listSelectedObjects(objects -> {
      // do something with the list of objects
    })
  });
SeatingChartView chart = new SeatingChartView(Region.EU, config, getApplicationContext())
        
setContentView(chart);

chart.getReportBySelectability()

SeatingChartConfig config = new SeatingChartConfig()
  .setWorkspaceKey("<yourPublicWorkspaceKey>")
  .setEvent("<yourEventKey>")
  .setOnChartRendered((chart) -> {
    chart.getReportBySelectability(report -> {
      // do something with the report
    })
  });
SeatingChartView chart = new SeatingChartView(Region.EU, config, getApplicationContext())
        
setContentView(chart);

Methods on seats (and other selectable objects)

SeatingChartConfig config = new SeatingChartConfig()
  .setWorkspaceKey("<yourPublicWorkspaceKey>")
  .setEvent("<yourEventKey>")
  .setSession(START)
  .setOnChartRendered((chart) -> {
    chart.selectObject("K-3"); // or chart.deselectObject("K-3"), chart.pulseObject("K-3"), ...
    chart.isObjectInChannel("K-3", "NO_CHANNEL", result -> Log.i("aTag", "In channel NO_CHANNEL? " + result));
  });
SeatingChartView chart = new SeatingChartView(Region.EU, config, getApplicationContext())
        
setContentView(chart);

Showing object labels

SeatingChartConfig config = new SeatingChartConfig()
  .setWorkspaceKey("<yourPublicWorkspaceKey>")
  .setEvent("<yourEventKey>")
  .setObjectLabel("object => object.labels.own"); // must be a valid Javascript function

setContentView(new SeatingChartView(Region.EU, config, getApplicationContext()));

Zooming to sections

AtomicBoolean rendered = new AtomicBoolean(false);
SeatingChartConfig config = new SeatingChartConfig()
  .setWorkspaceKey("<yourPublicWorkspaceKey>")
  .setEvent("<yourEventKey>")
  .setOnChartRendered((chart) -> rendered.set(true))
});
SeatingChartView chart = new SeatingChartView(Region.EU, config, getApplicationContext());
setContentView(chart);

final Button button = findViewById(R.id.go_to_section_button);
button.setOnClickListener((View v) -> {
  if (rendered.get()) {
    chart.zoomToSection("foo");
  }
});

Event manager

// this code should be inside an Activity
@Override
protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);
  EventManagerConfig config = new EventManagerConfig()
    .setSecretKey("<yourSecretKey>")
    .setEvent("<yourEventKey>")
    .setMode(MANAGE_OBJECT_STATUSES)
    .setLanguage("nl");
  
  setContentView(new EventManagerView(Region.EU, config, getApplicationContext()));
}

Some event manager modes have additional properties. To use these properties, instantiate one of the sub-classes of EventManagerConfig.

Documentation for the event manager is available at https://docs.seats.io/docs/event-manager

Configuring callbacks

In most cases, it's possible to pass in regular Java functions as callbacks:

new SeatingChartConfig().setOnObjectSelected((object, ticketType) -> /* do something */)

There are a few cases, such as objectLabel, where it is only possible to define functions using JavaScript because those functions are applied to each object in the chart and the performance overhead of using the JavaScript <-> Java bridge seriously degrades performance.

new SeatingChartConfig().setObjectLabelJavaScriptFunction("object => object.labels.own"); // must be a valid JavaScript function

Any callback which requires a JavaScript implementation is suffixed with JavaScriptFunction.