discoverBridges static method

Future<List<String>> discoverBridges({ Directory? savedBridgesDir, bool writeToLocal = true, String decrypter(String ciphertext)?, })

Searches the network for Philips Hue bridges.

Returns a list of all of their IP addresses.

If saved bridges are not saved to the default folder, provide their location with savedBridgesDir.

decrypter When the bridge data is read from local storage, it is decrypted. This parameter allows you to provide your own decryption method. This will be used in addition to the default decryption method. This will be performed after the default decryption method.

Implementation

static Future<List<String>> discoverBridges({
  Directory? savedBridgesDir,
  bool writeToLocal = true,
  String Function(String ciphertext)? decrypter,
}) async {
  /// The bridges already saved to this device.
  List<Bridge> savedBridges;

  if (kIsWeb) {
    // cookies instead of local storage (not yet implemented)
    savedBridges = [];
  } else {
    savedBridges = await fetchSavedBridges(
      decrypter: decrypter,
      directory: savedBridgesDir,
    );
  }

  /// Bridges found using MDNS.
  List<String> bridgesFromMdns;
  if (kIsWeb) {
    // mDNS does not work on web.
    bridgesFromMdns = [];
  } else {
    bridgesFromMdns = await BridgeDiscoveryService.discoverBridgesMdns();
  }

  /// Bridges found using the endpoint method.
  List<String> bridgesFromEndpoint =
      await BridgeDiscoveryService.discoverBridgesEndpoint();

  // Remove duplicates from the two search methods.
  Set<String> uniqueValues = {};
  uniqueValues.addAll(bridgesFromMdns);
  uniqueValues.addAll(bridgesFromEndpoint);

  if (savedBridges.isEmpty) return uniqueValues.toList();

  List<String> ipAddresses = [];

  // Remove the bridges that are already saved to the device from the search
  // results.
  for (String ip in uniqueValues) {
    for (Bridge bridge in savedBridges) {
      if (bridge.ipAddress == null || bridge.ipAddress != ip) {
        ipAddresses.add(ip);
      }
    }
  }

  // Keep locally saved bridges up to date.
  if (writeToLocal) {
    for (String ip in ipAddresses) {
      // This will go through each of the bridges who's IP address have just
      // been collected and tries to connect to them. If there is a successful
      // connection, then this isn't the first time contact has been made with
      // the bridge. In this case, the file will be overridden with the new IP
      // address.
      await firstContact(
        bridgeIpAddr: ip,
        savedBridgesDir: savedBridgesDir,
        writeToLocal: writeToLocal,
        controller: DiscoveryTimeoutController(timeoutSeconds: 1),
      );
    }
  }

  return ipAddresses;
}