blob: 3413a99bd343c99116ad44c6ebcc1bd8d909bd1d (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
|
// Copyright (c) 2012 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.
// MediaStreamProvider is used to capture media of the types defined in
// MediaStreamType. There is only one MediaStreamProvider instance per media
// type and a MediaStreamProvider instance can have only one registered
// listener.
// The MediaStreamManager is expected to be called on Browser::IO thread and
// the listener will be called on the same thread.
#ifndef CONTENT_BROWSER_RENDERER_HOST_MEDIA_MEDIA_STREAM_PROVIDER_H_
#define CONTENT_BROWSER_RENDERER_HOST_MEDIA_MEDIA_STREAM_PROVIDER_H_
#include <list>
#include <string>
#include "base/memory/ref_counted.h"
#include "content/common/content_export.h"
#include "content/common/media/media_stream_options.h"
namespace base {
class SingleThreadTaskRunner;
}
namespace content {
enum MediaStreamProviderError {
kMediaStreamOk = 0,
kInvalidMediaStreamType,
kInvalidSession,
kUnknownSession,
kDeviceNotAvailable,
kDeviceAlreadyInUse,
kUnknownError
};
enum { kInvalidMediaCaptureSessionId = 0xFFFFFFFF };
// Callback class used by MediaStreamProvider.
class CONTENT_EXPORT MediaStreamProviderListener {
public:
// Called by a MediaStreamProvider when a stream has been opened.
virtual void Opened(MediaStreamType stream_type, int capture_session_id) = 0;
// Called by a MediaStreamProvider when a stream has been closed.
virtual void Closed(MediaStreamType stream_type, int capture_session_id) = 0;
// Called by a MediaStreamProvider when available devices has been enumerated.
virtual void DevicesEnumerated(MediaStreamType stream_type,
const StreamDeviceInfoArray& devices) = 0;
// Called by a MediaStreamProvider when the device has been aborted due to
// device error.
virtual void Aborted(MediaStreamType stream_type, int capture_session_id) = 0;
protected:
virtual ~MediaStreamProviderListener() {}
};
// Implemented by a manager class providing captured media.
class CONTENT_EXPORT MediaStreamProvider
: public base::RefCountedThreadSafe<MediaStreamProvider> {
public:
// Registers a listener and a device message loop.
virtual void Register(MediaStreamProviderListener* listener,
const scoped_refptr<base::SingleThreadTaskRunner>&
device_task_runner) = 0;
// Unregisters the previously registered listener.
virtual void Unregister() = 0;
// Enumerates existing capture devices and calls |DevicesEnumerated|.
virtual void EnumerateDevices(MediaStreamType stream_type) = 0;
// Opens the specified device. The device is not started and it is still
// possible for other applications to open the device before the device is
// started. |Opened| is called when the device is opened.
// kInvalidMediaCaptureSessionId is returned on error.
virtual int Open(const StreamDeviceInfo& device) = 0;
// Closes the specified device and calls |Closed| when done.
virtual void Close(int capture_session_id) = 0;
protected:
friend class base::RefCountedThreadSafe<MediaStreamProvider>;
virtual ~MediaStreamProvider() {}
};
} // namespace content
#endif // CONTENT_BROWSER_RENDERER_HOST_MEDIA_MEDIA_STREAM_PROVIDER_H_
|
