faced/camera/cros_camera_service.h

// Copyright 2022 The ChromiumOS Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef FACED_CAMERA_CROS_CAMERA_SERVICE_H_
#define FACED_CAMERA_CROS_CAMERA_SERVICE_H_

#include <memory>
#include <string>
#include <string_view>

#include "faced/camera/camera_service.h"

namespace faced {

// CrosCameraService is a simple wrapper around cros::CameraServiceConnector
class CrosCameraService final : public CameraService {
 public:
  // Creates an instance of CrosCameraService using a given permission token.
  static std::unique_ptr<CrosCameraService> Create(
      std::string_view token_path_string = kDefaultCameraToken);

  // Initializes the connection to camera HAL dispatcher and registers the
  // camera HAL client. Must be called before any other functions.
  int Init() override;

  // Terminates camera HAL client, all connections and threads.
  int Exit() override;

  // Sets the callback for camera info changes and fires |callback| with the
  // info of the cameras currently present.
  int GetCameraInfo(cros_cam_get_cam_info_cb_t callback,
                    void* context) override;

  // Starts capturing with the given parameters.
  int StartCapture(const cros_cam_capture_request_t* request,
                   cros_cam_capture_cb_t callback,
                   void* context) override;

  // Stops capturing. Waits for the ongoing capture callback if there is any
  // underway.
  int StopCapture(int id) override;

  // The default camera permission token to hand to the CameraHAL.
  //
  // TODO(b/253130377): Stop using the test-only token, and organise
  // for `faced` to have a legitimate token.
  static constexpr std::string_view kDefaultCameraToken =
      "/run/camera_tokens/testing/token";

 private:
  explicit CrosCameraService(std::string_view token_path_string)
      : token_path_string_(token_path_string) {}

  const std::string token_path_string_;
};

}  // namespace faced

#endif  // FACED_CAMERA_CROS_CAMERA_SERVICE_H_