OLD | NEW |
1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. |
2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 // VideoCaptureManager is used to open/close, start/stop, enumerate available | 5 // VideoCaptureManager is used to open/close, start/stop, enumerate available |
6 // video capture devices, and manage VideoCaptureController's. | 6 // video capture devices, and manage VideoCaptureController's. |
7 // All functions are expected to be called from Browser::IO thread. Some helper | 7 // All functions are expected to be called from Browser::IO thread. Some helper |
8 // functions (*OnDeviceThread) will dispatch operations to the device thread. | 8 // functions (*OnDeviceThread) will dispatch operations to the device thread. |
9 // VideoCaptureManager will open OS dependent instances of VideoCaptureDevice. | 9 // VideoCaptureManager will open OS dependent instances of VideoCaptureDevice. |
10 // A device can only be opened once. | 10 // A device can only be opened once. |
(...skipping 40 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
51 | 51 |
52 virtual void Close(int capture_session_id) OVERRIDE; | 52 virtual void Close(int capture_session_id) OVERRIDE; |
53 | 53 |
54 // Used by unit test to make sure a fake device is used instead of a real | 54 // Used by unit test to make sure a fake device is used instead of a real |
55 // video capture device. Due to timing requirements, the function must be | 55 // video capture device. Due to timing requirements, the function must be |
56 // called before EnumerateDevices and Open. | 56 // called before EnumerateDevices and Open. |
57 void UseFakeDevice(); | 57 void UseFakeDevice(); |
58 | 58 |
59 // Called by VideoCaptureHost to locate a capture device for |capture_params|, | 59 // Called by VideoCaptureHost to locate a capture device for |capture_params|, |
60 // adding the Host as a client of the device's controller if successful. The | 60 // adding the Host as a client of the device's controller if successful. The |
61 // value of |capture_params.session_id| controls which device is selected; | 61 // value of |session_id| controls which device is selected; |
62 // this value should be a session id previously returned by Open(). | 62 // this value should be a session id previously returned by Open(). |
63 // | 63 // |
64 // If the device is not already started (i.e., no other client is currently | 64 // If the device is not already started (i.e., no other client is currently |
65 // capturing from this device), this call will cause a VideoCaptureController | 65 // capturing from this device), this call will cause a VideoCaptureController |
66 // and VideoCaptureDevice to be created, possibly asynchronously. | 66 // and VideoCaptureDevice to be created, possibly asynchronously. |
67 // | 67 // |
68 // On success, the controller is returned via calling |done_cb|, indicating | 68 // On success, the controller is returned via calling |done_cb|, indicating |
69 // that the client was successfully added. A NULL controller is passed to | 69 // that the client was successfully added. A NULL controller is passed to |
70 // the callback on failure. | 70 // the callback on failure. |
71 void StartCaptureForClient(const media::VideoCaptureParams& capture_params, | 71 void StartCaptureForClient(media::VideoCaptureSessionId session_id, |
| 72 const media::VideoCaptureParams& capture_params, |
72 base::ProcessHandle client_render_process, | 73 base::ProcessHandle client_render_process, |
73 VideoCaptureControllerID client_id, | 74 VideoCaptureControllerID client_id, |
74 VideoCaptureControllerEventHandler* client_handler, | 75 VideoCaptureControllerEventHandler* client_handler, |
75 const DoneCB& done_cb); | 76 const DoneCB& done_cb); |
76 | 77 |
77 // Called by VideoCaptureHost to remove |client_handler|. If this is the last | 78 // Called by VideoCaptureHost to remove |client_handler|. If this is the last |
78 // client of the device, the |controller| and its VideoCaptureDevice may be | 79 // client of the device, the |controller| and its VideoCaptureDevice may be |
79 // destroyed. The client must not access |controller| after calling this | 80 // destroyed. The client must not access |controller| after calling this |
80 // function. | 81 // function. |
81 void StopCaptureForClient(VideoCaptureController* controller, | 82 void StopCaptureForClient(VideoCaptureController* controller, |
(...skipping 31 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
113 | 114 |
114 // Queries and returns the available device IDs. | 115 // Queries and returns the available device IDs. |
115 media::VideoCaptureDevice::Names GetAvailableDevicesOnDeviceThread( | 116 media::VideoCaptureDevice::Names GetAvailableDevicesOnDeviceThread( |
116 MediaStreamType stream_type); | 117 MediaStreamType stream_type); |
117 | 118 |
118 // Create and Start a new VideoCaptureDevice, storing the result in | 119 // Create and Start a new VideoCaptureDevice, storing the result in |
119 // |entry->video_capture_device|. Ownership of |client| passes to | 120 // |entry->video_capture_device|. Ownership of |client| passes to |
120 // the device. | 121 // the device. |
121 void DoStartDeviceOnDeviceThread( | 122 void DoStartDeviceOnDeviceThread( |
122 DeviceEntry* entry, | 123 DeviceEntry* entry, |
123 const media::VideoCaptureCapability& capture_params, | 124 const media::VideoCaptureParams& params, |
124 scoped_ptr<media::VideoCaptureDevice::Client> client); | 125 scoped_ptr<media::VideoCaptureDevice::Client> client); |
125 | 126 |
126 // Stop and destroy the VideoCaptureDevice held in | 127 // Stop and destroy the VideoCaptureDevice held in |
127 // |entry->video_capture_device|. | 128 // |entry->video_capture_device|. |
128 void DoStopDeviceOnDeviceThread(DeviceEntry* entry); | 129 void DoStopDeviceOnDeviceThread(DeviceEntry* entry); |
129 | 130 |
130 // The message loop of media stream device thread, where VCD's live. | 131 // The message loop of media stream device thread, where VCD's live. |
131 scoped_refptr<base::MessageLoopProxy> device_loop_; | 132 scoped_refptr<base::MessageLoopProxy> device_loop_; |
132 | 133 |
133 // Only accessed on Browser::IO thread. | 134 // Only accessed on Browser::IO thread. |
(...skipping 42 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
176 // when a device is created in DoStartDeviceOnDeviceThread(). Used only on the | 177 // when a device is created in DoStartDeviceOnDeviceThread(). Used only on the |
177 // device thread. | 178 // device thread. |
178 media::VideoCaptureDevice::Names video_capture_devices_; | 179 media::VideoCaptureDevice::Names video_capture_devices_; |
179 | 180 |
180 DISALLOW_COPY_AND_ASSIGN(VideoCaptureManager); | 181 DISALLOW_COPY_AND_ASSIGN(VideoCaptureManager); |
181 }; | 182 }; |
182 | 183 |
183 } // namespace content | 184 } // namespace content |
184 | 185 |
185 #endif // CONTENT_BROWSER_RENDERER_HOST_MEDIA_VIDEO_CAPTURE_MANAGER_H_ | 186 #endif // CONTENT_BROWSER_RENDERER_HOST_MEDIA_VIDEO_CAPTURE_MANAGER_H_ |
OLD | NEW |