script/dom/media/
mediadevices.rs

1/* This Source Code Form is subject to the terms of the Mozilla Public
2 * License, v. 2.0. If a copy of the MPL was not distributed with this
3 * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
4
5use std::rc::Rc;
6
7use dom_struct::dom_struct;
8use servo_media::ServoMedia;
9use servo_media::streams::MediaStreamType;
10use servo_media::streams::capture::{Constrain, ConstrainRange, MediaTrackConstraintSet};
11
12use crate::conversions::Convert;
13use crate::dom::bindings::codegen::Bindings::MediaDevicesBinding::{
14    MediaDevicesMethods, MediaStreamConstraints,
15};
16use crate::dom::bindings::codegen::UnionTypes::{
17    BooleanOrMediaTrackConstraints, ClampedUnsignedLongOrConstrainULongRange as ConstrainULong,
18    DoubleOrConstrainDoubleRange as ConstrainDouble,
19};
20use crate::dom::bindings::reflector::{DomGlobal, reflect_dom_object};
21use crate::dom::bindings::root::DomRoot;
22use crate::dom::eventtarget::EventTarget;
23use crate::dom::globalscope::GlobalScope;
24use crate::dom::media::mediadeviceinfo::MediaDeviceInfo;
25use crate::dom::media::mediastream::MediaStream;
26use crate::dom::media::mediastreamtrack::MediaStreamTrack;
27use crate::dom::promise::Promise;
28use crate::realms::{AlreadyInRealm, InRealm};
29use crate::script_runtime::CanGc;
30
31#[dom_struct]
32pub(crate) struct MediaDevices {
33    eventtarget: EventTarget,
34}
35
36impl MediaDevices {
37    pub(crate) fn new_inherited() -> MediaDevices {
38        MediaDevices {
39            eventtarget: EventTarget::new_inherited(),
40        }
41    }
42
43    pub(crate) fn new(global: &GlobalScope, can_gc: CanGc) -> DomRoot<MediaDevices> {
44        reflect_dom_object(Box::new(MediaDevices::new_inherited()), global, can_gc)
45    }
46}
47
48impl MediaDevicesMethods<crate::DomTypeHolder> for MediaDevices {
49    /// <https://w3c.github.io/mediacapture-main/#dom-mediadevices-getusermedia>
50    fn GetUserMedia(
51        &self,
52        constraints: &MediaStreamConstraints,
53        comp: InRealm,
54        can_gc: CanGc,
55    ) -> Rc<Promise> {
56        let p = Promise::new_in_current_realm(comp, can_gc);
57        let media = ServoMedia::get();
58        let stream = MediaStream::new(&self.global(), can_gc);
59        if let Some(constraints) = convert_constraints(&constraints.audio) {
60            if let Some(audio) = media.create_audioinput_stream(constraints) {
61                let track =
62                    MediaStreamTrack::new(&self.global(), audio, MediaStreamType::Audio, can_gc);
63                stream.add_track(&track);
64            }
65        }
66        if let Some(constraints) = convert_constraints(&constraints.video) {
67            if let Some(video) = media.create_videoinput_stream(constraints) {
68                let track =
69                    MediaStreamTrack::new(&self.global(), video, MediaStreamType::Video, can_gc);
70                stream.add_track(&track);
71            }
72        }
73
74        p.resolve_native(&stream, can_gc);
75        p
76    }
77
78    /// <https://w3c.github.io/mediacapture-main/#dom-mediadevices-enumeratedevices>
79    fn EnumerateDevices(&self, can_gc: CanGc) -> Rc<Promise> {
80        // Step 1.
81        let in_realm_proof = AlreadyInRealm::assert::<crate::DomTypeHolder>();
82        let p = Promise::new_in_current_realm(InRealm::Already(&in_realm_proof), can_gc);
83
84        // Step 2.
85        // XXX These steps should be run in parallel.
86        // XXX Steps 2.1 - 2.4
87
88        // Step 2.5
89        let media = ServoMedia::get();
90        let device_monitor = media.get_device_monitor();
91        let result_list = device_monitor
92            .enumerate_devices()
93            .map(|devices| {
94                devices
95                    .iter()
96                    .map(|device| {
97                        // XXX The media backend has no way to group devices yet.
98                        MediaDeviceInfo::new(
99                            &self.global(),
100                            &device.device_id,
101                            device.kind.convert(),
102                            &device.label,
103                            "",
104                            can_gc,
105                        )
106                    })
107                    .collect::<Vec<_>>()
108            })
109            .unwrap_or_default();
110
111        p.resolve_native(&result_list, can_gc);
112
113        // Step 3.
114        p
115    }
116}
117
118fn convert_constraints(js: &BooleanOrMediaTrackConstraints) -> Option<MediaTrackConstraintSet> {
119    match js {
120        BooleanOrMediaTrackConstraints::Boolean(false) => None,
121        BooleanOrMediaTrackConstraints::Boolean(true) => Some(Default::default()),
122        BooleanOrMediaTrackConstraints::MediaTrackConstraints(c) => Some(MediaTrackConstraintSet {
123            height: c.parent.height.as_ref().and_then(convert_culong),
124            width: c.parent.width.as_ref().and_then(convert_culong),
125            aspect: c.parent.aspectRatio.as_ref().and_then(convert_cdouble),
126            frame_rate: c.parent.frameRate.as_ref().and_then(convert_cdouble),
127            sample_rate: c.parent.sampleRate.as_ref().and_then(convert_culong),
128        }),
129    }
130}
131
132fn convert_culong(js: &ConstrainULong) -> Option<Constrain<u32>> {
133    match js {
134        ConstrainULong::ClampedUnsignedLong(val) => Some(Constrain::Value(*val)),
135        ConstrainULong::ConstrainULongRange(range) => {
136            if range.parent.min.is_some() || range.parent.max.is_some() {
137                Some(Constrain::Range(ConstrainRange {
138                    min: range.parent.min,
139                    max: range.parent.max,
140                    ideal: range.ideal,
141                }))
142            } else {
143                range.exact.map(Constrain::Value)
144            }
145        },
146    }
147}
148
149fn convert_cdouble(js: &ConstrainDouble) -> Option<Constrain<f64>> {
150    match js {
151        ConstrainDouble::Double(val) => Some(Constrain::Value(**val)),
152        ConstrainDouble::ConstrainDoubleRange(range) => {
153            if range.parent.min.is_some() || range.parent.max.is_some() {
154                Some(Constrain::Range(ConstrainRange {
155                    min: range.parent.min.map(|x| *x),
156                    max: range.parent.max.map(|x| *x),
157                    ideal: range.ideal.map(|x| *x),
158                }))
159            } else {
160                range.exact.map(|exact| Constrain::Value(*exact))
161            }
162        },
163    }
164}
script/dom/media/mediadevices.rs

script/dom/media/
mediadevices.rs
