Initial public release of nearby library

Signed-off-by: Alexey Polyudov <apolyudov@google.com>
Change-Id: I85d490e448375aa4eb7b09680757c02fff1420b4

cpp/platform/api/server_sync.h

@@ -0,0 +1,78 @@
+// 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_SERVER_SYNC_H_
+#define PLATFORM_API_SERVER_SYNC_H_
+
+#include <string>
+
+#include "platform/byte_array.h"
+#include "platform/ptr.h"
+
+namespace location {
+namespace nearby {
+
+// Abstraction that represents a Nearby endpoint exchanging data through
+// ServerSync Medium.
+class ServerSyncDevice {
+ public:
+  virtual ~ServerSyncDevice() {}
+
+  virtual std::string getName() = 0;
+
+  virtual std::string getGuid() = 0;
+
+  virtual std::string getOwnGuid() = 0;
+};
+
+// Container of operations that can be performed over the Chrome Sync medium.
+class ServerSyncMedium {
+ public:
+  virtual ~ServerSyncMedium() {}
+
+  // Takes ownership of (and is responsible for destroying) the passed-in
+  // 'endpoint_info'.
+  virtual bool startAdvertising(const std::string& service_id,
+                                const std::string& endpoint_id,
+                                ConstPtr<ByteArray> endpoint_info) = 0;
+  virtual void stopAdvertising(const std::string& service_id) = 0;
+
+  class DiscoveredDeviceCallback {
+   public:
+    virtual ~DiscoveredDeviceCallback() {}
+
+    // Called on a new ServerSyncDevice discovery.
+    virtual void onDeviceDiscovered(Ptr<ServerSyncDevice> device,
+                                    const std::string& service_id,
+                                    const std::string& endpoint_id,
+                                    ConstPtr<ByteArray> endpoint_info) = 0;
+    // Called when ServerSyncDevice is no longer reachable.
+    virtual void onDeviceLost(Ptr<ServerSyncDevice> device,
+                              const std::string& service_id) = 0;
+  };
+
+  // Returns true once the Chrome Sync scan has been initiated.
+  virtual bool startDiscovery(
+      const std::string& service_id,
+      Ptr<DiscoveredDeviceCallback> discovered_device_callback) = 0;
+  // Returns true once Chrome Sync scan for service_id is well and truly
+  // stopped; after this returns, there must be no more invocations of the
+  // DiscoveredDeviceCallback passed in to startScanning() for service_id.
+  virtual void stopDiscovery(const std::string& service_id) = 0;
+};
+
+}  // namespace nearby
+}  // namespace location
+
+#endif  // PLATFORM_API_SERVER_SYNC_H_