mirror of
https://github.com/kidfromjupiter/nearby.git
synced 2026-09-16 15:36:12 -04:00
Janusz Sobczak
ddbb711b7b
Creates plugins/ directory which will store internal plugins used for admin tasks and testing. In this CL * FakeFastPairPlugin for tests * InitalPairPlugin - simple plugin that triggers Initial Pair flow PiperOrigin-RevId: 536775192
80 lines
3.1 KiB
C++
80 lines
3.1 KiB
C++
// Copyright 2023 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 THIRD_PARTY_NEARBY_FASTPAIR_FAST_PAIR_SEEKER_H_
|
|
#define THIRD_PARTY_NEARBY_FASTPAIR_FAST_PAIR_SEEKER_H_
|
|
|
|
#include "absl/functional/any_invocable.h"
|
|
#include "absl/status/status.h"
|
|
#include "fastpair/common/fast_pair_device.h"
|
|
|
|
namespace nearby {
|
|
namespace fastpair {
|
|
|
|
// Pairing result callback.
|
|
struct PairingCallback {
|
|
absl::AnyInvocable<void(const FastPairDevice&, absl::Status)>
|
|
on_pairing_result =
|
|
[](const FastPairDevice& device, absl::Status status) {};
|
|
};
|
|
|
|
// Initial Pairing parameters.
|
|
struct InitialPairingParam {};
|
|
|
|
// Subsequent Pairing parameters.
|
|
struct SubsequentPairingParam {};
|
|
|
|
// Retroactive Pairing parameters.
|
|
struct RetroactivePairingParam {};
|
|
|
|
// Fast Pair Seeker API available to plugins.
|
|
class FastPairSeeker {
|
|
public:
|
|
virtual ~FastPairSeeker() = default;
|
|
|
|
// Starts asynchronous initial pairing flow. This pairing flow is used with
|
|
// devices that we see for the first time.
|
|
//
|
|
// Returns an error if pairing flow could not be started. Otherwise, the
|
|
// pairing result will be returned via the `callback`.
|
|
virtual absl::Status StartInitialPairing(const FastPairDevice& device,
|
|
const InitialPairingParam& params,
|
|
PairingCallback callback) = 0;
|
|
|
|
// Starts asynchronous subsequent pairing flow. This pairing flow is used when
|
|
// device is an already known peripheral. The user paired with that device in
|
|
// the past, perhaps using a different seeker and `device` already has an
|
|
// Account Key.
|
|
//
|
|
// Returns an error if pairing flow could not be started. Otherwise, the
|
|
// pairing result will be returned via the `callback`.
|
|
virtual absl::Status StartSubsequentPairing(
|
|
const FastPairDevice& device, const SubsequentPairingParam& params,
|
|
PairingCallback callback) = 0;
|
|
|
|
// Starts asynchronous retroactive pairing flow. This pairing flow is used
|
|
// when the user has paired manually with a new device and we want to
|
|
// retroactively exchange an Account Key. See:
|
|
// https://developers.google.com/nearby/fast-pair/specifications/extensions/retroactiveacctkey
|
|
//
|
|
// Returns an error if pairing flow could not be started. Otherwise, the
|
|
// pairing result will be returned via the `callback`.
|
|
virtual absl::Status StartRetroactivePairing(
|
|
const FastPairDevice& device, const RetroactivePairingParam& param,
|
|
PairingCallback callback) = 0;
|
|
};
|
|
} // namespace fastpair
|
|
} // namespace nearby
|
|
#endif // THIRD_PARTY_NEARBY_FASTPAIR_FAST_PAIR_SEEKER_H_
|