dpp::activity Class Reference

An activity is a representation of what a user is doing. It might be a game, or a website, or a movie. Whatever. More...

#include <presence.h>

Collaboration diagram for dpp::activity:

Public Member Functions
	activity ()
	activity (const activity_type typ, const std::string &nam, const std::string &stat, const std::string &url_)
	Construct a new activity. More...
std::string	get_large_asset_url (uint16_t size=0, const image_type format=i_png) const
	Get the assets large image url if they have one, otherwise returns an empty string. In case of prefixed image IDs (mp:{image_id}) it returns an empty string. More...
std::string	get_small_asset_url (uint16_t size=0, const image_type format=i_png) const
	Get the assets small image url if they have one, otherwise returns an empty string. In case of prefixed image IDs (mp:{image_id}) it returns an empty string. More...

Public Attributes
snowflake	application_id
activity_assets	assets
std::vector< activity_button >	buttons
time_t	created_at
std::string	details
dpp::emoji	emoji
time_t	end
uint8_t	flags
bool	is_instance
std::string	name
activity_party	party
activity_secrets	secrets
time_t	start
std::string	state
activity_type	type
std::string	url

Detailed Description

An activity is a representation of what a user is doing. It might be a game, or a website, or a movie. Whatever.

Constructor & Destructor Documentation

activity() [1/2]

dpp::activity::activity

(

)

activity() [2/2]

dpp::activity::activity	(	const activity_type	typ,
		const std::string &	nam,
		const std::string &	stat,
		const std::string &	url_
	)

Construct a new activity.

Parameters

typ	activity type
nam	Name of the activity
stat	State of the activity
url_	url of the activity, only works for certain sites, such as YouTube

Member Function Documentation

get_large_asset_url()

std::string dpp::activity::get_large_asset_url	(	uint16_t	size = 0,
		const image_type	format = i_png
	)		const

Get the assets large image url if they have one, otherwise returns an empty string. In case of prefixed image IDs (mp:{image_id}) it returns an empty string.

See also

https://discord.com/developers/docs/topics/gateway-events#activity-object-activity-asset-image

Parameters

size	The size of the image in pixels. It can be any power of two between 16 and 4096, otherwise the default sized image is returned.
format	The format to use for the avatar. It can be one of i_webp, i_jpg or i_png.

Returns

std::string image url or an empty string, if required attributes are missing or an invalid format was passed

get_small_asset_url()

std::string dpp::activity::get_small_asset_url	(	uint16_t	size = 0,
		const image_type	format = i_png
	)		const

Get the assets small image url if they have one, otherwise returns an empty string. In case of prefixed image IDs (mp:{image_id}) it returns an empty string.

See also

https://discord.com/developers/docs/topics/gateway-events#activity-object-activity-asset-image

Parameters

size	The size of the image in pixels. It can be any power of two between 16 and 4096, otherwise the default sized image is returned.
format	The format to use for the avatar. It can be one of i_webp, i_jpg or i_png.

Returns

std::string image url or an empty string, if required attributes are missing or an invalid format was passed

Member Data Documentation

application_id

snowflake dpp::activity::application_id

Creating application (e.g. a linked account on the user's client)

assets

activity_assets dpp::activity::assets

Images for the presence and their hover texts

buttons

std::vector<activity_button> dpp::activity::buttons

The custom buttons shown in the Rich Presence (max 2)

created_at

time_t dpp::activity::created_at

Time activity was created

details

std::string dpp::activity::details

What the player is currently doing

emoji

dpp::emoji dpp::activity::emoji

The emoji used for the custom status

end

time_t dpp::activity::end

End time, e.g. for songs on spotify

flags

uint8_t dpp::activity::flags

Flags bitmask from dpp::activity_flags

is_instance

bool dpp::activity::is_instance

Whether or not the activity is an instanced game session

name

std::string dpp::activity::name

Name of activity e.g. "Fortnite"

party

activity_party dpp::activity::party

Information of the current party if there is one

secrets

activity_secrets dpp::activity::secrets

Secrets for rich presence joining and spectating

start

time_t dpp::activity::start

Start time. e.g. when game was started

state

std::string dpp::activity::state

State of activity or the custom user status. e.g. "Waiting in lobby"

type

activity_type dpp::activity::type

Activity type

url

std::string dpp::activity::url

URL. Only applicable for certain sites such a YouTube Alias: details