mirror of
https://github.com/kidfromjupiter/nearby.git
synced 2026-09-16 15:36:12 -04:00
Suet-Fei Li
b6b692b0ea
Part 1: Implement internal common code Add implementation/g3 skeleton code for testing coverage. PiperOrigin-RevId: 485067018
77 lines
2.7 KiB
C++
77 lines
2.7 KiB
C++
// Copyright 2022 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_DIRECT_H_
|
|
#define PLATFORM_API_WIFI_DIRECT_H_
|
|
|
|
#include <memory>
|
|
#include <string>
|
|
#include <utility>
|
|
|
|
#include "internal/platform/cancellation_flag.h"
|
|
#include "internal/platform/implementation/wifi_hotspot.h"
|
|
#include "internal/platform/wifi_hotspot_credential.h"
|
|
|
|
namespace location {
|
|
namespace nearby {
|
|
namespace api {
|
|
|
|
// Container of operations that can be performed over the WifiLan medium.
|
|
class WifiDirectMedium {
|
|
public:
|
|
virtual ~WifiDirectMedium() = default;
|
|
|
|
// If the WiFi Adaptor supports to start a WifiDirect interface.
|
|
virtual bool IsInterfaceValid() const = 0;
|
|
|
|
// Connects to a WifiDirect service by port.
|
|
// On success, returns a new WifiDirectSocket.
|
|
// On error, returns nullptr.
|
|
virtual std::unique_ptr<WifiHotspotSocket> ConnectToService(
|
|
absl::string_view ip_address, int port,
|
|
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 WifiDirectServerSocket.
|
|
// On error, returns nullptr.
|
|
virtual std::unique_ptr<WifiHotspotServerSocket> ListenForService(
|
|
int port) = 0;
|
|
|
|
// Start a WifiDirect GO 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 WifiDirect GO with these credentials.
|
|
virtual bool StartWifiDirect(HotspotCredentials* wifi_direct_credentials) = 0;
|
|
virtual bool StopWifiDirect() = 0;
|
|
|
|
// Client device connect to a softAP with specified credential.
|
|
virtual bool ConnectWifiDirect(
|
|
HotspotCredentials* wifi_direct_credentials) = 0;
|
|
virtual bool DisconnectWifiDirect() = 0;
|
|
|
|
// Returns the port range as a pair of min and max port.
|
|
virtual absl::optional<std::pair<std::int32_t, std::int32_t>>
|
|
GetDynamicPortRange() = 0;
|
|
};
|
|
|
|
} // namespace api
|
|
} // namespace nearby
|
|
} // namespace location
|
|
|
|
#endif // PLATFORM_API_WIFI_DIRECT_H_
|