asterisk-rs-ari 0.8.0

Async Rust client for the Asterisk REST Interface (ARI)
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

//! recording control operations — live and stored.

use crate::client::{AriClient, url_encode};
use crate::error::Result;
use crate::event::LiveRecording;

/// stored recording metadata
#[derive(Debug, Clone, serde::Deserialize)]
#[non_exhaustive]
pub struct StoredRecording {
    pub name: String,
    pub format: String,
}

/// handle to a live ari recording
#[derive(Debug, Clone)]
pub struct RecordingHandle {
    name: String,
    client: AriClient,
}

impl RecordingHandle {
    pub fn new(name: impl Into<String>, client: AriClient) -> Self {
        Self {
            name: name.into(),
            client,
        }
    }

    pub fn name(&self) -> &str {
        &self.name
    }

    /// stop the live recording
    pub async fn stop(&self) -> Result<()> {
        self.client
            .post_empty(&format!("/recordings/live/{}/stop", url_encode(&self.name)))
            .await
    }

    /// pause the live recording
    pub async fn pause(&self) -> Result<()> {
        self.client
            .post_empty(&format!(
                "/recordings/live/{}/pause",
                url_encode(&self.name)
            ))
            .await
    }

    /// unpause the live recording
    pub async fn unpause(&self) -> Result<()> {
        self.client
            .delete(&format!(
                "/recordings/live/{}/pause",
                url_encode(&self.name)
            ))
            .await
    }

    /// mute the live recording
    pub async fn mute(&self) -> Result<()> {
        self.client
            .post_empty(&format!("/recordings/live/{}/mute", url_encode(&self.name)))
            .await
    }

    /// unmute the live recording
    pub async fn unmute(&self) -> Result<()> {
        self.client
            .delete(&format!("/recordings/live/{}/mute", url_encode(&self.name)))
            .await
    }

    /// get current live recording state
    pub async fn get(&self) -> Result<LiveRecording> {
        self.client
            .get(&format!("/recordings/live/{}", url_encode(&self.name)))
            .await
    }
}

/// list all stored recordings
pub async fn list_stored(client: &AriClient) -> Result<Vec<StoredRecording>> {
    client.get("/recordings/stored").await
}