medea-jason 0.13.0

Client library for Medea media server.
Documentation 
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
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138

//! Adapters to [Media Capture and Streams API][1].
//!
//! [1]: https://w3.org/TR/mediacapture-streams

pub mod constraints;
mod manager;
pub mod track;

use derive_more::with_trait::Display;
use medea_client_api_proto::MediaType;

#[doc(inline)]
pub use self::{
    constraints::{
        AudioSource, DeviceAudioTrackConstraints, DeviceVideoTrackConstraints,
        DisplayAudioTrackConstraints, DisplayVideoTrackConstraints, FacingMode,
        LocalTracksConstraints, MediaStreamSettings, MediaTrackConstraints,
        MultiSourceTracksConstraints, NoiseSuppressionLevel, RecvConstraints,
        TrackConstraints, VideoSource,
    },
    manager::{
        EnumerateDevicesError, EnumerateDisplaysError, GetDisplayMediaError,
        GetUserMediaError, HandleDetachedError, InitLocalTracksError,
        InvalidOutputAudioDeviceIdError, MediaManager, MediaManagerHandleImpl,
        MicVolumeError,
    },
    track::{
        AudioLevelError, AudioProcessingError, MediaSourceKind,
        MediaStreamTrackState, remote::MediaDirection,
    },
};

/// [MediaStreamTrack.kind][1] representation.
///
/// [1]: https://w3.org/TR/mediacapture-streams#dom-mediastreamtrack-kind
#[derive(Clone, Copy, Debug, Display, Eq, PartialEq)]
#[repr(u8)]
pub enum MediaKind {
    /// Audio track.
    #[display("audio")]
    Audio = 0,

    /// Video track.
    #[display("video")]
    Video = 1,
}

impl MediaKind {
    /// Returns string representation of a [`MediaKind`].
    #[must_use]
    pub const fn as_str(self) -> &'static str {
        match self {
            Self::Audio => "audio",
            Self::Video => "video",
        }
    }
}

impl From<&TrackConstraints> for MediaKind {
    fn from(media_type: &TrackConstraints) -> Self {
        match media_type {
            TrackConstraints::Audio(_) => Self::Audio,
            TrackConstraints::Video(_) => Self::Video,
        }
    }
}

impl From<&MediaType> for MediaKind {
    fn from(media_type: &MediaType) -> Self {
        match media_type {
            MediaType::Audio(_) => Self::Audio,
            MediaType::Video(_) => Self::Video,
        }
    }
}

/// [MediaDeviceInfo.kind][1] representation.
///
/// [1]: https://w3.org/TR/mediacapture-streams#dom-mediadeviceinfo-kind
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
#[repr(u8)]
pub enum MediaDeviceKind {
    /// Audio input device (for example, a microphone).
    AudioInput = 0,

    /// Video input device (for example, a webcam).
    VideoInput = 1,

    /// Audio output device (for example, a pair of headphones).
    AudioOutput = 2,
}

/// Possible kinds of audio devices.
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
#[repr(u8)]
pub enum AudioDeviceKind {
    /// Built-in earpiece speaker.
    EarSpeaker = 0,

    /// Built-in loudspeaker.
    Speakerphone = 1,

    /// Wired headphones without microphone.
    WiredHeadphones = 2,

    /// Wired headset with a microphone.
    WiredHeadset = 3,

    /// USB headphones without microphone.
    UsbHeadphones = 4,

    /// USB headset with a microphone.
    UsbHeadset = 5,

    /// Bluetooth headphones profile (A2DP/BLE speaker).
    BluetoothHeadphones = 6,

    /// Bluetooth headset profile suitable for calls (SCO/BLE headset).
    BluetoothHeadset = 7,
}

impl TryFrom<i64> for AudioDeviceKind {
    type Error = ();

    fn try_from(value: i64) -> Result<Self, Self::Error> {
        Ok(match value {
            0 => Self::EarSpeaker,
            1 => Self::Speakerphone,
            2 => Self::WiredHeadphones,
            3 => Self::WiredHeadset,
            4 => Self::UsbHeadphones,
            5 => Self::UsbHeadset,
            6 => Self::BluetoothHeadphones,
            7 => Self::BluetoothHeadset,
            _ => return Err(()),
        })
    }
}