// Copyright 2017 The Chromium Authors. All rights reserved.

// Use of this source code is governed by a BSD-style license that can be

// found in the LICENSE file.

import 'dart:async';

import 'package:flutter/services.dart';
import 'package:connectivity_platform_interface/connectivity_platform_interface.
dart';

// Export enums from the platform_interface so plugin users can use them directl
y.
export 'package:connectivity_platform_interface/connectivity_platform_interface.
dart'
show ConnectivityResult, LocationAuthorizationStatus;

/// Discover network connectivity configurations: Distinguish between WI-FI and

cellular, check WI-FI status and more.
class Connectivity {
/// Constructs a singleton instance of [Connectivity].
///
/// [Connectivity] is designed to work as a singleton.
// When a second instance is created, the first instance will not be able to l
isten to the
// EventChannel because it is overridden. Forcing the class to be a singleton
class can prevent
// misuse of creating a second instance from a programmer.
factory Connectivity() {
if (_singleton == null) {
_singleton = Connectivity._();
}
return _singleton;
}

Connectivity._();

static Connectivity _singleton;

static ConnectivityPlatform get _platform => ConnectivityPlatform.instance;

/// Fires whenever the connectivity state changes.

Stream<ConnectivityResult> get onConnectivityChanged {
return _platform.onConnectivityChanged;
}

/// Checks the connection status of the device.

///
/// Do not use the result of this function to decide whether you can reliably
/// make a network request. It only gives you the radio status.
///
/// Instead listen for connectivity changes via [onConnectivityChanged] stream
.
Future<ConnectivityResult> checkConnectivity() {
return _platform.checkConnectivity();
}
/// Obtains the wifi name (SSID) of the connected network
///
/// Please note that it DOESN'T WORK on emulators (returns null).
///
/// From android 8.0 onwards the GPS must be ON (high accuracy)
/// in order to be able to obtain the SSID.
 Future<String> getWifiName() {
return _platform.getWifiName();
}

/// Obtains the wifi BSSID of the connected network.

///
/// Please note that it DOESN'T WORK on emulators (returns null).
///
/// From Android 8.0 onwards the GPS must be ON (high accuracy)
/// in order to be able to obtain the BSSID.
Future<String> getWifiBSSID() {
return _platform.getWifiBSSID();
}

/// Obtains the IP address of the connected wifi network

Future<String> getWifiIP() {
return _platform.getWifiIP();
}

/// Request to authorize the location service (Only on iOS).

///
/// This method will throw a [PlatformException] on Android.
///
/// Returns a [LocationAuthorizationStatus] after user authorized or denied th
e location on this request.
///
/// If the location information needs to be accessible all the time, set `requ
estAlwaysLocationUsage` to true. If user has
/// already granted a [LocationAuthorizationStatus.authorizedWhenInUse] prior
to requesting an "always" access, it will return [LocationAuthorizationStatus.de
nied].
///
/// If the location service authorization is not determined prior to making th
is call, a platform standard UI of requesting a location service will pop up.
/// This UI will only show once unless the user re-install the app to their ph
one which resets the location service authorization to not determined.
///
/// This method is a helper to get the location authorization that is necessar
y for certain functionality of this plugin.
/// It can be replaced with other permission handling code/plugin if preferred
.
/// To request location authorization, make sure to add the following keys to
your _Info.plist_ file, located in `<project root>/ios/Runner/Info.plist`:
/// * `NSLocationAlwaysAndWhenInUseUsageDescription` - describe why the app ne
eds access to the user’s location information
/// all the time (foreground and background). This is called _Privacy - Locati
on Always and When In Use Usage Description_ in the visual editor.
/// * `NSLocationWhenInUseUsageDescription` - describe why the app needs acces
s to the user’s location information when the app is
/// running in the foreground. This is called _Privacy - Location When In Use
Usage Description_ in the visual editor.
///
/// Starting from iOS 13, `getWifiBSSID` and `getWifiIP` will only work proper
ly if:
///
/// * The app uses Core Location, and has the user’s authorization to use loca
tion information.
/// * The app uses the NEHotspotConfiguration API to configure the current Wi-
Fi network.
/// * The app has active VPN configurations installed.
///
/// If the app falls into the first category, call this method before calling
`getWifiBSSID` or `getWifiIP`.
/// For example,
/// ```dart
/// if (Platform.isIOS) {
/// LocationAuthorizationStatus status = await _connectivity.getLocationServ
iceAuthorization();
/// if (status == LocationAuthorizationStatus.notDetermined) {
/// status = await _connectivity.requestLocationServiceAuthorization();
/// }
/// if (status == LocationAuthorizationStatus.authorizedAlways || status ==
LocationAuthorizationStatus.authorizedWhenInUse) {
/// wifiBSSID = await _connectivity.getWifiName();
/// } else {
/// print('location service is not authorized, the data might not be corre
ct');
/// wifiBSSID = await _connectivity.getWifiName();
/// }
/// } else {
/// wifiBSSID = await _connectivity.getWifiName();
/// }
/// ```
///
/// Ideally, a location service authorization should only be requested if the
current authorization status is not determined.
///
/// See also [getLocationServiceAuthorization] to obtain current location serv
ice status.
Future<LocationAuthorizationStatus> requestLocationServiceAuthorization({
bool requestAlwaysLocationUsage = false,
}) {
return _platform.requestLocationServiceAuthorization(
requestAlwaysLocationUsage: requestAlwaysLocationUsage,
);
}

/// Get the current location service authorization (Only on iOS).

///
/// This method will throw a [PlatformException] on Android.
///
/// Returns a [LocationAuthorizationStatus].
/// If the returned value is [LocationAuthorizationStatus.notDetermined], a su
bsequent [requestLocationServiceAuthorization] call
/// can request the authorization.
/// If the returned value is not [LocationAuthorizationStatus.notDetermined],
a subsequent [requestLocationServiceAuthorization]
/// will not initiate another request. It will instead return the "determined"
status.
///
/// This method is a helper to get the location authorization that is necessar
y for certain functionality of this plugin.
/// It can be replaced with other permission handling code/plugin if preferred
.
///
/// Starting from iOS 13, `getWifiBSSID` and `getWifiIP` will only work proper
ly if:
///
/// * The app uses Core Location, and has the user’s authorization to use loca
tion information.
/// * The app uses the NEHotspotConfiguration API to configure the current Wi-
Fi network.
/// * The app has active VPN configurations installed.
///
 /// If the app falls into the first category, call this method before calling
`getWifiBSSID` or `getWifiIP`.
/// For example,
/// ```dart
/// if (Platform.isIOS) {
/// LocationAuthorizationStatus status = await _connectivity.getLocationServ
iceAuthorization();
/// if (status == LocationAuthorizationStatus.authorizedAlways || status ==
LocationAuthorizationStatus.authorizedWhenInUse) {
/// wifiBSSID = await _connectivity.getWifiName();
/// } else {
/// print('location service is not authorized, the data might not be corre
ct');
/// wifiBSSID = await _connectivity.getWifiName();
/// }
/// } else {
/// wifiBSSID = await _connectivity.getWifiName();
/// }
/// ```
///
/// See also [requestLocationServiceAuthorization] for requesting a location s
ervice authorization.
Future<LocationAuthorizationStatus> getLocationServiceAuthorization() {
return _platform.getLocationServiceAuthorization();
}
}