What You'll Learn

GoDice
  1. Download Android Studio
  2. Install Flutter SDK

If on Mac:

  1. Install xCode

Platforms supported:

Install another_go_dice

flutter pub add another_go_dice

The another_go_dice library abstracts the BLE connection via the use of adapters. In order to start searching for GoDice devices we call:

    PlusBleAdapter.getInstance().startScan();

There discovered devices will be available through a stream in the plugin:

    PlusBleAdapter.getInstance().getScanResults();

And continue to search until stopped by calling:

    PlusBleAdapter.getInstance().stopScan();

The GoDice will appear along every other Bluetooth Low Energy (BLE) device near the mobile device. In order to filter in the GoDice we can check on the device name:

    BleGoDiceDeviceOwner buildDeviceOwner({required IBleDevice device}) {
    if (device.getName().contains("GoDice")) {

      BleGoDiceDeviceOwner deviceOwner = BleGoDiceDeviceOwner(device: device);
      return deviceOwner;
    }
    return UnknownBleGoDieDeviceOwner(device: device);
  }

Once the GoDice is found and wrapped in a BleGoDiceDeviceOwner die-specific operations like connect can be performed on the die. To connect to a GoDice we call:

    goDice.handleEvent(
        event: BleConnectDeviceEvent(
            device: goDice.device))

In the same fashion we can disconnect from a GoDice by calling:

    goDice.handleEvent(
        event: BleDisconnectDeviceEvent(
            device: goDice.device));

All connection state changes are made available though a stream and may be listened for via:

    goDice.getSetupStates().listen((setupState) {
      if (setupState == BleSetupState.initial) {
        // DO something when the goDice is in the initial setup state.
      }
    });

Once the GoDice is connected to we can listen for die roll results. The GoDice will send two main events related to rolls, one even to notify it is being rolled and one event with the result of the roll.

To listen to the GoDice roll events the following streaming API is used:

  goDice.getDieMessages().listen((message) {

    if (message is GoDiceRollingMessage) {
      // TODO The die is in the process of being rolled, do something.
    }
    if (die.getDieType() == DieType.d6) {
      if (message is GoDiceRollMessage) {
        if (message.getValue() == 6) {
          // A 6 was rolled
        }
        else if (message.getValue() == 5) {
          // A 5 was rolled
        }
        else if (message.getValue() == 4) {
          // A 4 was rolled
        }
        else if (message.getValue() == 3) {
          // A 3 was rolled
        }
        else if (message.getValue() == 2) {
          // A 2 was rolled
        }
        else if (message.getValue() == 1) {
          // A 1 was rolled
        }
      }
    }

  });