Struct DiscordIPC

Source

pub struct DiscordIPC { /* private fields */ }

Expand description

Async Discord IPC client.

Implementations§

Source §

impl DiscordIPC

Source

pub async fn new(client_id: &str) -> Result<Self>

Create a new IPC instance (does NOT start connection). To start a connection and run the client, use .run().

Examples found in repository ?

examples/indefinite.rs (line 6)

5async fn main() -> Result<()> {
6    let mut client = DiscordIPC::new("1463450870480900160").await?;
7
8    let handle = client.run().await?; // spawns IPC loop
9    client.set_activity("this runs", "forever").await?; // set activity
10
11    handle.await??;
12    Ok(())
13}

More examples

Hide additional examples

examples/timed.rs (line 8)

7async fn main() {
8    let mut client = DiscordIPC::new("1463450870480900160").await.unwrap();
9
10    client.run().await.unwrap();
11
12    client
13        .set_activity("this runs", "for ten seconds")
14        .await
15        .unwrap();
16    sleep(Duration::from_secs(5)).await;
17    client.set_activity("believe it", "or not").await.unwrap();
18    sleep(Duration::from_secs(5)).await;
19}

Source

pub async fn run(&mut self) -> Result<JoinHandle<Result<()>>>

Connect, handshake, wait for READY and start the IPC client.

Examples found in repository ?

examples/indefinite.rs (line 8)

5async fn main() -> Result<()> {
6    let mut client = DiscordIPC::new("1463450870480900160").await?;
7
8    let handle = client.run().await?; // spawns IPC loop
9    client.set_activity("this runs", "forever").await?; // set activity
10
11    handle.await??;
12    Ok(())
13}

More examples

Hide additional examples

examples/timed.rs (line 10)

7async fn main() {
8    let mut client = DiscordIPC::new("1463450870480900160").await.unwrap();
9
10    client.run().await.unwrap();
11
12    client
13        .set_activity("this runs", "for ten seconds")
14        .await
15        .unwrap();
16    sleep(Duration::from_secs(5)).await;
17    client.set_activity("believe it", "or not").await.unwrap();
18    sleep(Duration::from_secs(5)).await;
19}

Source

pub async fn set_activity(&self, details: &str, state: &str) -> Result<()>

Sets the Discord Rich presence activity.

Examples found in repository ?

examples/indefinite.rs (line 9)

5async fn main() -> Result<()> {
6    let mut client = DiscordIPC::new("1463450870480900160").await?;
7
8    let handle = client.run().await?; // spawns IPC loop
9    client.set_activity("this runs", "forever").await?; // set activity
10
11    handle.await??;
12    Ok(())
13}

More examples

Hide additional examples

examples/timed.rs (line 13)

7async fn main() {
8    let mut client = DiscordIPC::new("1463450870480900160").await.unwrap();
9
10    client.run().await.unwrap();
11
12    client
13        .set_activity("this runs", "for ten seconds")
14        .await
15        .unwrap();
16    sleep(Duration::from_secs(5)).await;
17    client.set_activity("believe it", "or not").await.unwrap();
18    sleep(Duration::from_secs(5)).await;
19}