activity-macros

Crates.ioactivity-macros
lib.rsactivity-macros
version0.1.3
sourcesrc
created_at2024-03-26 13:34:15.637502
updated_at2024-03-28 10:46:45.305295
descriptionMacros for Discord activities in Rust
homepage
repositoryhttps://github.com/merlinfuchs/activity-rs
max_upload_size
id1186437
size5,272
Merlin (merlinfuchs)

documentation

README

activities-rs

Ergonomic Rust bindings to the Discord Embedded App SDK.

Work in Progress

  • Support for all commands
  • Support for all events

Example Usage

use activity::*;
use std::{mem::forget, option_env};

#[activity]
pub async fn start() -> Result<(), JsValue> {
    console_log!("Starting activity...");

    let client_id = option_env!("CLIENT_ID").expect("CLIENT_ID environment variable must be set");
    let sdk = DiscordSDK::new(client_id)?;
    sdk.ready().await?;

    console_log!("Activity ready!");

    authenticate_user(&sdk).await?;

    let s = sdk
        .subscribe(
            |e: VoiceStateUpdateEvent| {
                console_log!("Voice state update: {:?}", e);
                Ok(())
            },
            SubscribeArgs::channel_id(sdk.channel_id().unwrap()),
        )
        .await?;

    // When the subscription is dropped, the event will be unsubscribed
    forget(s);

    Ok(())
}

async fn authenticate_user(sdk: &DiscordSDK) -> Result<(), JsValue> {
    let res = sdk
        .authorize(AuthorizeCommandArgs {
            client_id: sdk.client_id(),
            response_type: "code".to_string(),
            state: "".to_string(),
            prompt: "none".to_string(),
            scope: vec![
                "identify".to_string(),
                "guilds".to_string(),
                "rpc.voice.read".to_string(),
            ],
        })
        .await?;

    // The token exchange must happen through your own server. Implement this yourself!
    let access_token = exchange_token(&res.code).await?;

    let res = sdk
        .authenticate(AuthenticateCommandArgs { access_token })
        .await?;

    console_log!("Authenticated user: {:?}", res.user);

    Ok(())
}

Compiling an Activity

There is a build tool that makes it really easy to compile and bundle Rust activities. The finished bundle will be located in build/activity.

Alternatively you can also use webpack with the wasm-pack plugin. See the webpack example.

# Install the build tool
cargo install activity-build

# Set env vars
export CLIENT_ID=1234567890

# Run it in the directory where your `Cargo.toml` is located
activity-build --release
Commit count: 15

cargo fmt