mediaway-device 0.1.2

Device capture: camera, microphone, screen/window, audio playback + hotplug, with Windows/Linux/Web backends as #[cfg]-gated modules
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

//! Preference types shared by wasm and host stubs.

#![forbid(unsafe_code)]

use wasm_bindgen::prelude::*;

/// Optional hints for [`crate::web::open_display_capture`]. All fields are best-effort only.
#[wasm_bindgen]
#[derive(Default)]
pub struct DisplayCapturePreferences {
    display_surface_hint: Option<String>,
}

#[wasm_bindgen]
impl DisplayCapturePreferences {
    /// Empty preferences (browser default picker).
    #[wasm_bindgen(constructor)]
    #[allow(clippy::missing_const_for_fn, reason = "wasm_bindgen constructor")]
    pub fn new() -> Self {
        Self {
            display_surface_hint: None,
        }
    }

    /// Hint `displaySurface` when supported.
    #[wasm_bindgen(getter)]
    pub fn display_surface_hint(&self) -> Option<String> {
        // clone: wasm getter returns owned String
        self.display_surface_hint.clone()
    }

    /// Set `displaySurface` hint (`monitor` / `window` / `browser`).
    #[wasm_bindgen(setter)]
    pub fn set_display_surface_hint(&mut self, hint: Option<String>) {
        self.display_surface_hint = hint;
    }
}

/// Optional hints for camera/mic capture. `device_id` is not guaranteed.
#[wasm_bindgen]
pub struct UserMediaPreferences {
    video: bool,
    audio: bool,
    device_id_hint: Option<String>,
}

#[wasm_bindgen]
impl UserMediaPreferences {
    /// Request video and/or audio.
    #[wasm_bindgen(constructor)]
    #[allow(clippy::missing_const_for_fn, reason = "wasm_bindgen constructor")]
    pub fn new(video: bool, audio: bool) -> Self {
        Self {
            video,
            audio,
            device_id_hint: None,
        }
    }

    /// Request video track.
    #[wasm_bindgen(getter)]
    #[allow(clippy::missing_const_for_fn, reason = "wasm_bindgen getter")]
    pub fn video(&self) -> bool {
        self.video
    }

    /// Request audio track.
    #[wasm_bindgen(getter)]
    #[allow(clippy::missing_const_for_fn, reason = "wasm_bindgen getter")]
    pub fn audio(&self) -> bool {
        self.audio
    }

    /// Optional `deviceId` hint (not guaranteed).
    #[wasm_bindgen(getter)]
    pub fn device_id_hint(&self) -> Option<String> {
        // clone: wasm getter returns owned String
        self.device_id_hint.clone()
    }

    /// Set optional `deviceId` hint.
    #[wasm_bindgen(setter)]
    pub fn set_device_id_hint(&mut self, id: Option<String>) {
        self.device_id_hint = id;
    }
}