Source code
Revision control
Copy as Markdown
Other Tools
/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/* vim: set sw=2 ts=8 et ft=cpp : */
/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this file,
#ifndef MOZILLA_VIDEO_CAPTURE_FACTORY_H_
#define MOZILLA_VIDEO_CAPTURE_FACTORY_H_
#include "modules/video_capture/video_capture_factory.h"
#include "modules/video_capture/video_capture_options.h"
#include "modules/video_capture/video_capture.h"
#include "mozilla/MozPromise.h"
namespace mozilla::camera {
enum class CaptureDeviceType;
}
namespace webrtc {
class DesktopCaptureImpl;
}
namespace mozilla {
/**
* NOTE: This class must be accessed only on a single SerialEventTarget
*/
class VideoCaptureFactory : webrtc::VideoCaptureOptions::Callback {
public:
NS_INLINE_DECL_THREADSAFE_REFCOUNTING(VideoCaptureFactory);
enum CameraAvailability { Unknown, Available, NotAvailable };
VideoCaptureFactory();
std::shared_ptr<webrtc::VideoCaptureModule::DeviceInfo> CreateDeviceInfo(
int32_t aId, mozilla::camera::CaptureDeviceType aType);
struct CreateVideoCaptureResult {
rtc::scoped_refptr<webrtc::VideoCaptureModule> mCapturer;
// Pointer to the DesktopCaptureImpl instance if mCapturer is of this type.
// nullptr otherwise.
webrtc::DesktopCaptureImpl* mDesktopImpl = nullptr;
};
CreateVideoCaptureResult CreateVideoCapture(
int32_t aModuleId, const char* aUniqueId,
mozilla::camera::CaptureDeviceType aType);
using CameraBackendInitPromise = MozPromise<nsresult, nsresult, false>;
/**
* Request to initialize webrtc::VideoCaptureOptions
*
* Resolves with NS_OK when VideoCaptureOptions has been properly initialized
* or rejects with one of the possible errors. Since this is only now
* supported by PipeWire, all the errors are PipeWire specific:
* 1) NS_ERROR_NOT_AVAILABLE - PipeWire libraries are not available on
* the system
* 2) NS_ERROR_DOM_MEDIA_NOT_ALLOWED_ERR - camera access has been rejected
* 3) NS_ERROR_FAILURE - generic error, usually a PipeWire failure
*/
RefPtr<CameraBackendInitPromise> InitCameraBackend();
/**
* Updates information about camera availability
*/
using UpdateCameraAvailabilityPromise =
MozPromise<CameraAvailability, nsresult, true>;
RefPtr<UpdateCameraAvailabilityPromise> UpdateCameraAvailability();
private:
~VideoCaptureFactory() = default;
// aka OnCameraBackendInitialized
// this method override has to follow webrtc::VideoCaptureOptions::Callback
void OnInitialized(webrtc::VideoCaptureOptions::Status status) override;
/**
* Resolves with true or false depending on whether there is a camera device
* advertised by the xdg-desktop-portal (Camera portal). Rejects with one
* of the following errors:
* 1) NS_ERROR_NOT_IMPLEMENTED - support for the Camera portal is not
* implemented or enabled
* 2) NS_ERROR_NO_INTERFACE - the camera portal is not available
* 3) NS_ERROR_UNEXPECTED - the camera portal returned wrong value
*/
using HasCameraDevicePromise = MozPromise<CameraAvailability, nsresult, true>;
RefPtr<HasCameraDevicePromise> HasCameraDevice();
std::atomic<bool> mCameraBackendInitialized = false;
CameraAvailability mCameraAvailability = Unknown;
#if (defined(WEBRTC_LINUX) || defined(WEBRTC_BSD)) && !defined(WEBRTC_ANDROID)
std::unique_ptr<webrtc::VideoCaptureOptions> mVideoCaptureOptions;
#endif
MozPromiseHolder<CameraBackendInitPromise> mPromiseHolder;
RefPtr<CameraBackendInitPromise> mPromise;
};
} // namespace mozilla
#endif // MOZILLA_VIDEO_CAPTURE_FACTORY_H_