mirror of
https://github.com/kidfromjupiter/nearby.git
synced 2026-09-15 07:06:11 -04:00
123 lines
4.3 KiB
C++
123 lines
4.3 KiB
C++
// Copyright 2020 Google LLC
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// https://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
|
|
#ifndef PLATFORM_API_WIFI_HOTSPOT_H_
|
|
#define PLATFORM_API_WIFI_HOTSPOT_H_
|
|
|
|
#include <cstdint>
|
|
#include <memory>
|
|
#include <optional>
|
|
#include <utility>
|
|
|
|
#include "internal/platform/cancellation_flag.h"
|
|
#include "internal/platform/exception.h"
|
|
#include "internal/platform/input_stream.h"
|
|
#include "internal/platform/output_stream.h"
|
|
#include "internal/platform/wifi_credential.h"
|
|
|
|
namespace nearby {
|
|
namespace api {
|
|
|
|
class WifiHotspotSocket {
|
|
public:
|
|
virtual ~WifiHotspotSocket() = default;
|
|
|
|
// Returns the InputStream of the WifiHotspotSocket.
|
|
// On error, returned stream will report Exception::kIo on any operation.
|
|
//
|
|
// The returned object is not owned by the caller, and can be invalidated once
|
|
// the WifiHotspotSocket object is destroyed.
|
|
virtual InputStream& GetInputStream() = 0;
|
|
|
|
// Returns the OutputStream of the WifiHotspotSocket.
|
|
// On error, returned stream will report Exception::kIo on any operation.
|
|
//
|
|
// The returned object is not owned by the caller, and can be invalidated once
|
|
// the WifiHotspotSocket object is destroyed.
|
|
virtual OutputStream& GetOutputStream() = 0;
|
|
|
|
// Returns Exception::kIo on error, Exception::kSuccess otherwise.
|
|
virtual Exception Close() = 0;
|
|
};
|
|
|
|
class WifiHotspotServerSocket {
|
|
public:
|
|
virtual ~WifiHotspotServerSocket() = default;
|
|
|
|
virtual int GetPort() const = 0;
|
|
|
|
// Blocks until either:
|
|
// - at least one incoming connection request is available, or
|
|
// - ServerSocket is closed.
|
|
// On success, returns connected socket, ready to exchange data.
|
|
// Returns nullptr on error.
|
|
// Once error is reported, it is permanent, and ServerSocket has to be closed.
|
|
virtual std::unique_ptr<WifiHotspotSocket> Accept() = 0;
|
|
|
|
// Returns Exception::kIo on error, Exception::kSuccess otherwise.
|
|
virtual Exception Close() = 0;
|
|
|
|
// Populates the hotspot credentials with the server socket's service
|
|
// addresses and ports.
|
|
virtual void PopulateHotspotCredentials(
|
|
HotspotCredentials& hotspot_credentials) = 0;
|
|
};
|
|
|
|
// Container of operations that can be performed over the WifiHotspot medium.
|
|
class WifiHotspotMedium {
|
|
public:
|
|
virtual ~WifiHotspotMedium() = default;
|
|
|
|
// If the WiFi Adaptor supports to start a Hotspot interface.
|
|
virtual bool IsInterfaceValid() const = 0;
|
|
|
|
// Connects to a WifiHotspot service by ip address and port.
|
|
// On success, returns a new WifiHotspotSocket.
|
|
// On error, returns nullptr.
|
|
virtual std::unique_ptr<WifiHotspotSocket> ConnectToService(
|
|
const ServiceAddress& service_address,
|
|
CancellationFlag* cancellation_flag) = 0;
|
|
|
|
// Listens for incoming connection.
|
|
//
|
|
// port - A port number.
|
|
// 0 : use a random port.
|
|
// 1~65536 : open a server socket on that exact port.
|
|
// On success, returns a new WifiHotspotServerSocket.
|
|
// On error, returns nullptr.
|
|
virtual std::unique_ptr<WifiHotspotServerSocket> ListenForService(
|
|
int port) = 0;
|
|
|
|
// Start a softAP as Hotspot with platform dependent APIs and set the
|
|
// SSID/password pair back to the credentials. BWU module will retrieve these
|
|
// credentials and send to the client device through established channel and
|
|
// then client may connect to this Hotspot with these credentials.
|
|
virtual bool StartWifiHotspot(HotspotCredentials* hotspot_credentials) = 0;
|
|
virtual bool StopWifiHotspot() = 0;
|
|
|
|
// Client device connect to a softAP with specified credential.
|
|
virtual bool ConnectWifiHotspot(
|
|
const HotspotCredentials& hotspot_credentials) = 0;
|
|
virtual bool DisconnectWifiHotspot() = 0;
|
|
|
|
// Returns the port range as a pair of min and max port.
|
|
virtual std::optional<std::pair<std::int32_t, std::int32_t>>
|
|
GetDynamicPortRange() = 0;
|
|
};
|
|
|
|
} // namespace api
|
|
} // namespace nearby
|
|
|
|
#endif // PLATFORM_API_WIFI_HOTSPOT_H_
|