busylib 0.0.2

BUSY Bar Rust HTTP client
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

//! Audio endpoints

use crate::client::Call;
use crate::error::Result;
use crate::model::audio::{AudioVolumeInfo, PlayAudio};
use crate::transport::HttpTransport;
use crate::types::volume::Volume;

crate::api::endpoint!(
    /// Audio controls
    Audio
);

impl<T: HttpTransport> Audio<'_, T> {
    /// Play audio file
    ///
    /// Plays an audio file from the assets directory.
    /// Supported formats include .snd files.
    pub async fn play(&self, audio: &PlayAudio) -> Result<()> {
        let request = Call::post("/busybar/audio/play").json(audio)?;
        self.client.ok(request).await
    }

    /// Stop audio playback
    ///
    /// Stops any currently playing audio
    pub async fn stop(&self) -> Result<()> {
        self.client.ok(Call::delete("/busybar/audio/play")).await
    }

    /// Get audio volume
    ///
    /// Get audio volume value
    pub async fn volume(&self) -> Result<Volume> {
        let response: AudioVolumeInfo =
            self.client.json(Call::get("/busybar/audio/volume")).await?;
        Ok(response.volume)
    }

    /// Set audio volume
    ///
    /// Set audio volume value
    pub async fn set_volume(&self, volume: Volume) -> Result<()> {
        self.set(volume, false).await
    }

    /// Set audio volume silently
    ///
    /// Set audio volume value
    pub async fn set_volume_silently(&self, volume: Volume) -> Result<()> {
        self.set(volume, true).await
    }

    async fn set(&self, volume: Volume, silent: bool) -> Result<()> {
        let request = Call::post("/busybar/audio/volume")
            .query("volume", volume.percent())
            .query("silent", u8::from(silent));
        self.client.ok(request).await
    }
}