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 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158
use crate::{
proto::{Command, CommandKind},
user::UserId,
Error,
};
use serde::{de, ser, Deserialize, Serialize};
pub mod events;
pub mod state;
#[derive(Clone, Debug)]
pub enum InputMode {
VoiceActivity,
PushToTalk { shortcut: String },
}
impl<'de> Deserialize<'de> for InputMode {
fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
where
D: de::Deserializer<'de>,
{
#[derive(Deserialize)]
struct Inner<'stack> {
#[serde(rename = "type")]
kind: &'stack str,
shortcut: Option<&'stack str>,
}
let inner = Inner::<'de>::deserialize(deserializer)?;
Ok(match inner.kind {
"VOICE_ACTIVITY" => Self::VoiceActivity,
"PUSH_TO_TALK" => Self::PushToTalk {
shortcut: inner.shortcut.unwrap_or_default().to_owned(),
},
other => return Err(de::Error::custom(format!("unknown variant '{}'", other))),
})
}
}
impl Serialize for InputMode {
fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
where
S: ser::Serializer,
{
use ser::SerializeStruct;
let mut state = serializer.serialize_struct("InputMode", 2)?;
match self {
Self::VoiceActivity => {
state.serialize_field("type", "VOICE_ACTIVITY")?;
// HACK: Discord will give errors if shortcut is not supplied AND it's a string AND it's not empty :(
state.serialize_field("shortcut", "_")?;
}
Self::PushToTalk { shortcut } => {
state.serialize_field("type", "PUSH_TO_TALK")?;
state.serialize_field("shortcut", shortcut)?;
}
}
state.end()
}
}
/// Settings for the local user's voice connection
#[derive(Serialize)]
pub struct VoiceSettingsSelf {
/// Mutes or unmutes the currently connected user.
///
/// [API docs](https://discord.com/developers/docs/game-sdk/discord-voice#setselfmute)
pub self_mute: bool,
/// Deafens or undefeans the currently connected user.
///
/// [API docs](https://discord.com/developers/docs/game-sdk/discord-voice#setselfdeaf)
pub self_deaf: bool,
}
impl crate::Discord {
/// Changes whether the local user is muted and/or deafened
pub async fn update_voice_settings(&self, settings: VoiceSettingsSelf) -> Result<(), Error> {
let rx = self.send_rpc(CommandKind::SetVoiceSettings, settings)?;
handle_response!(rx, Command::SetVoiceSettings => {
Ok(())
})
}
/// Sets a new voice input mode for the user. Refer to [Shortcut Keys](
/// https://discord.com/developers/docs/game-sdk/discord-voice#data-models-shortcut-keys)
/// for a table of valid values for shortcuts.
///
/// [API docs](https://discord.com/developers/docs/game-sdk/discord-voice#setinputmode)
pub async fn voice_set_input_mode(&self, input_mode: InputMode) -> Result<(), Error> {
#[derive(Serialize)]
struct SetInputMode {
input_mode: InputMode,
}
let rx = self.send_rpc(CommandKind::SetVoiceSettings, SetInputMode { input_mode })?;
handle_response!(rx, Command::SetVoiceSettings => {
Ok(())
})
}
/// Mutes or unmutes the given user for the currently connected user.
///
/// [API docs](https://discord.com/developers/docs/game-sdk/discord-voice#setlocalmute)
pub async fn voice_mute_user(&self, user: UserId, mute: bool) -> Result<(), Error> {
#[derive(Serialize)]
struct UserMute {
user_id: UserId,
mute: bool,
}
let rx = self.send_rpc(
CommandKind::SetUserVoiceSettings,
UserMute {
user_id: user,
mute,
},
)?;
handle_response!(rx, Command::SetUserVoiceSettings => {
Ok(())
})
}
/// Sets the local volume for a given user. This is the volume level at
/// which the currently connected users hears the given user speak. Valid
/// volume values are from 0 to 200, with 100 being the default. Lower than
/// 100 will be a reduced volume level from default, whereas over 100 will
/// be a boosted volume level from default.
///
/// [API docs](https://discord.com/developers/docs/game-sdk/discord-voice#setlocalvolume)
pub async fn voice_set_user_volume(&self, user: UserId, volume: u8) -> Result<u8, Error> {
#[derive(Serialize)]
struct UserVolume {
user_id: UserId,
volume: u8,
}
let volume = std::cmp::min(volume, 200);
let rx = self.send_rpc(
CommandKind::SetUserVoiceSettings,
UserVolume {
user_id: user,
volume,
},
)?;
handle_response!(rx, Command::SetUserVoiceSettings => {
Ok(volume)
})
}
}