naiveproxy/services/video_capture/public/interfaces/device_factory.mojom

41 lines
1.7 KiB
Plaintext
Raw Normal View History

2018-01-28 19:30:36 +03:00
// Copyright 2016 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
module video_capture.mojom;
import "media/capture/mojo/video_capture_types.mojom";
import "services/video_capture/public/interfaces/device.mojom";
enum DeviceAccessResultCode {
NOT_INITIALIZED,
SUCCESS,
ERROR_DEVICE_NOT_FOUND
};
// Enables access to a set of video capture devices.
// Typical operation is to first call GetDeviceInfos() to obtain
// information about available devices. The |device_id| of the infos can
// subsequently be used to create an instance of
// video_capture.mojom.Device using CreateDevice().
// The factory guarantees that no two device infos it returns use the
// same |device_id|.
interface DeviceFactory {
GetDeviceInfos()
=> (array<media.mojom.VideoCaptureDeviceInfo> device_infos);
// Provides exclusive access to the device identified by |device_id|.
// The access is valid until either the message pipe associated with
// |device_request| is closed by the client, or a subsequent call to
// CreateDevice() is made. When a subsequent call is made while the
// |device_request| from a previous call has not yet been closed, the service
// "revokes" that previous |device_request| (by closing the connection) and
// the exclusive access goes to the new |device_request|.
// Note: This design avoids the issue of it not being clear how soon after a
// |device_request| has been (asynchronously) discarded a subsequent call to
// CreateDevice() would succeed if it were to deny access while still
// in use.
CreateDevice(string device_id, Device& device_request)
=> (DeviceAccessResultCode result_code);
};