Struct serenity::model::gateway::Activity

pub struct Activity {
    pub application_id: Option<ApplicationId>,
    pub assets: Option<ActivityAssets>,
    pub details: Option<String>,
    pub flags: Option<ActivityFlags>,
    pub instance: Option<bool>,
    pub kind: ActivityType,
    pub name: String,
    pub party: Option<ActivityParty>,
    pub secrets: Option<ActivitySecrets>,
    pub state: Option<String>,
    pub emoji: Option<ActivityEmoji>,
    pub timestamps: Option<ActivityTimestamps>,
    pub url: Option<String>,
    // some fields omitted
}

Representation of an activity that a User is performing.

Fields

application_id: Option<ApplicationId>

The ID of the application for the activity.

assets: Option<ActivityAssets>

Images for the presence and their texts.

details: Option<String>

What the user is doing.

flags: Option<ActivityFlags>

Activity flags describing what the payload includes.

instance: Option<bool>

Whether or not the activity is an instanced game session.

kind: ActivityType

The type of activity being performed

name: String

The name of the activity.

party: Option<ActivityParty>

Information about the user's current party.

secrets: Option<ActivitySecrets>

Secrets for Rich Presence joining and spectating.

state: Option<String>

The user's current party status.

emoji: Option<ActivityEmoji>

Emoji currently used in custom status

timestamps: Option<ActivityTimestamps>

Unix timestamps for the start and/or end times of the activity.

url: Option<String>

The Stream URL if kind is ActivityType::Streaming.

Methods

impl Activity

pub fn playing(name: &str) -> Activity

Creates a Game struct that appears as a Playing <name> status.

Note: Maximum name length is 128.

Examples

Create a command that sets the current activity:

use serenity::model::gateway::Activity;
use serenity::model::channel::Message;
use serenity::framework::standard::{Args, CommandResult, macros::command};
use serenity::client::Context;

#[command]
fn activity(ctx: &mut Context, _msg: &Message, args: Args) -> CommandResult {
    let name = args.message();
    ctx.set_activity(Activity::playing(&name));

    Ok(())
}

pub fn streaming(name: &str, url: &str) -> Activity

Creates an Activity struct that appears as a Streaming <name> status.

Note: Maximum name length is 128.

Examples

Create a command that sets the current streaming status:

use serenity::model::gateway::Activity;
use serenity::model::channel::Message;
use serenity::framework::standard::{Args, CommandResult, macros::command};
use serenity::client::Context;

#[command]
fn stream(ctx: &mut Context, _msg: &Message, args: Args) -> CommandResult {
    const STREAM_URL: &str = "...";

    let name = args.message();
    ctx.set_activity(Activity::streaming(&name, STREAM_URL));

    Ok(())
}

pub fn listening(name: &str) -> Activity

Creates a Game struct that appears as a Listening to <name> status.

Note: Maximum name length is 128.

Examples

Create a command that sets the current listening status:

use serenity::model::gateway::Activity;
use serenity::model::channel::Message;
use serenity::framework::standard::{Args, CommandResult, macros::command};
use serenity::client::Context;

#[command]
fn listen(ctx: &mut Context, _msg: &Message, args: Args) -> CommandResult {
    let name = args.message();
    ctx.set_activity(Activity::listening(&name));

    Ok(())
}

Trait Implementations

impl Clone for Activity

fn clone(&self) -> Activity

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Activity

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Activity

fn deserialize<D: Deserializer<'de>>(
    deserializer: D
) -> StdResult<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl Serialize for Activity

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
    __S: Serializer, 

Serialize this value into the given Serde serializer.