OLD | NEW |
| (Empty) |
1 // Copyright 2016 The Chromium Authors. All rights reserved. | |
2 // Use of this source code is governed by a BSD-style license that can be | |
3 // found in the LICENSE file. | |
4 | |
5 module video_capture.mojom; | |
6 | |
7 import "media/capture/mojo/video_capture_types.mojom"; | |
8 import "services/video_capture/public/interfaces/video_capture_device_descriptor
.mojom"; | |
9 import "services/video_capture/public/interfaces/video_capture_device_proxy.mojo
m"; | |
10 import "services/video_capture/public/interfaces/video_capture_settings.mojom"; | |
11 | |
12 enum DeviceAccessResultCode { | |
13 NOT_INITIALIZED, | |
14 SUCCESS, | |
15 ERROR_DEVICE_NOT_FOUND | |
16 }; | |
17 | |
18 // Enables access to a set of video capture devices. | |
19 // Typical operation is to first call EnumerateDeviceDescriptors() to obtain | |
20 // information about available devices. The |device_id| of the descriptors can | |
21 // subsequently be used to either obtain the supported formats for a device | |
22 // using GetSupportedFormats(), or to create an instance of | |
23 // VideoCaptureDeviceProxy using CreateDeviceProxy(). | |
24 // The factory guarantees that no two device descriptors it returns use the | |
25 // same |device_id|. | |
26 interface VideoCaptureDeviceFactory { | |
27 EnumerateDeviceDescriptors() | |
28 => (array<VideoCaptureDeviceDescriptor> descriptors); | |
29 | |
30 GetSupportedFormats(string device_id) | |
31 => (array<VideoCaptureFormat> supported_formats); | |
32 | |
33 // Provides exclusive access to the device identified by |device_id|. | |
34 // The access is valid until either the message pipe associated with | |
35 // |proxy_request| is closed by the client, or a subsequent call to | |
36 // CreateDeviceProxy() is made. When a subsequent call is made while the | |
37 // |proxy_request| from a previous call has not yet been closed, the service | |
38 // "revokes" that previous |proxy_request| (by closing the connection) and the | |
39 // exclusive access goes to the new |proxy_request|. | |
40 // Note: This design avoids the issue of it not being clear how soon after a | |
41 // |proxy_request| has been (asynchronously) discarded a subsequent call to | |
42 // CreateDeviceProxy() would succeed if it were to deny access while still | |
43 // in use. | |
44 CreateDeviceProxy(string device_id, | |
45 VideoCaptureDeviceProxy& proxy_request) | |
46 => (DeviceAccessResultCode result_code); | |
47 }; | |
OLD | NEW |