botrs 0.13.0

A Rust QQ Bot framework based on QQ Guild Bot API
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

use super::{BotApi, resource};
use crate::audio::AudioControl;
use crate::error::Result;
use tracing::debug;

impl BotApi {
    // Audio APIs

    /// Updates audio control and discards the submitted body.
    pub async fn update_audio(&self, channel_id: &str, audio_control: &AudioControl) -> Result<()> {
        self.post_audio(channel_id, audio_control).await?;
        Ok(())
    }

    /// Updates audio control and returns the submitted control body.
    pub async fn post_audio(
        &self,
        channel_id: &str,
        audio_control: &AudioControl,
    ) -> Result<AudioControl> {
        debug!("Updating audio in channel {}", channel_id);
        let path = resource::channel_audio(channel_id);
        let _response = self
            .http
            .post(self.token(), &path, None::<&()>, Some(audio_control))
            .await?;
        Ok(audio_control.clone())
    }

    /// Enables the bot microphone in an audio channel.
    pub async fn on_microphone(&self, channel_id: &str) -> Result<()> {
        debug!("Turning on microphone in channel {}", channel_id);
        let path = resource::channel_mic(channel_id);
        self.http
            .put(self.token(), &path, None::<&()>, None::<&()>)
            .await?;
        Ok(())
    }

    /// Disables the bot microphone in an audio channel.
    pub async fn off_microphone(&self, channel_id: &str) -> Result<()> {
        debug!("Turning off microphone in channel {}", channel_id);
        let path = resource::channel_mic(channel_id);
        self.http.delete(self.token(), &path, None::<&()>).await?;
        Ok(())
    }
}