Package net.dv8tion.jda.api.entities

Interface StageInstance

All Superinterfaces:

ISnowflake

public interface StageInstance
extends ISnowflake

A Stage Instance holds information about a live stage.

This instance indicates an active stage channel with speakers, usually to host events such as presentations or meetings.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static enum	StageInstance.PrivacyLevel	The privacy level for a stage instance.

Method Summary

Modifier and Type	Method	Description
RestAction<Void>	delete()	Deletes this stage instance
default List<Member>	getAudience()	All current audience members of this stage instance.
StageChannel	getChannel()	The StageChannel for this stage instance
Guild	getGuild()	The Guild this stage instance is in
StageInstanceManager	getManager()	The StageInstanceManager used to update this stage instance.
StageInstance.PrivacyLevel	getPrivacyLevel()	The StageInstance.PrivacyLevel of this stage instance
default List<Member>	getSpeakers()	All current speakers of this stage instance.
String	getTopic()	The topic of this stage instance

Methods inherited from interface net.dv8tion.jda.api.entities.ISnowflake

getId, getIdLong, getTimeCreated

Method Details

getGuild

@Nonnull
Guild getGuild()

The Guild this stage instance is in

Returns:

The Guild

getChannel

@Nonnull
StageChannel getChannel()

The StageChannel for this stage instance

Returns:

The StageChannel

getTopic

@Nonnull
String getTopic()

The topic of this stage instance

Returns:

The topic

getPrivacyLevel

@Nonnull
StageInstance.PrivacyLevel getPrivacyLevel()

The StageInstance.PrivacyLevel of this stage instance

Returns:

The StageInstance.PrivacyLevel

getSpeakers

@Nonnull
default List<Member> getSpeakers()

All current speakers of this stage instance.

A member is considered a speaker when they are currently connected to the stage channel and their voice state is not suppressed. When a member is not a speaker, they are part of the audience.

Only stage moderators can promote or invite speakers. A stage moderator can move between speaker and audience at any time.

Returns:

Immutable List of Members which can speak in this stage instance

getAudience

@Nonnull
default List<Member> getAudience()

All current audience members of this stage instance.

A member is considered part of the audience when they are currently connected to the stage channel and their voice state is suppressed. When a member is not part of the audience, they are considered a speaker.

Only stage moderators can promote or invite speakers. A stage moderator can move between speaker and audience at any time.

Returns:

Immutable List of Members which cannot speak in this stage instance

delete

@Nonnull
@CheckReturnValue
RestAction<Void> delete()

Deletes this stage instance

Possible ErrorResponses include:

• UNKNOWN_STAGE_INSTANCE
  If this stage instance is already deleted
• UNKNOWN_CHANNEL
  If the channel was deleted

Returns:

RestAction

Throws:

InsufficientPermissionException - If the self member is not a stage moderator

getManager

@Nonnull
@CheckReturnValue
StageInstanceManager getManager()

The StageInstanceManager used to update this stage instance.

This can be used to update multiple fields such as topic and privacy level in one request

If this stage instance is already deleted, this will fail with ErrorResponse.UNKNOWN_STAGE_INSTANCE.

Returns:

The StageInstanceManager

Throws:

InsufficientPermissionException - If the self member is not a stage moderator