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

script/dom/media/
mediadevices.rs
