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 class
StageInstance.PrivacyLevel
The privacy level for a stage instance.
-
Method Summary
All Methods Instance Methods Abstract Methods Default Methods Deprecated Methods Modifier and Type Method Description RestAction<Void>
delete()
Deletes this stage instancedefault List<Member>
getAudience()
All current audience members of this stage instance.StageChannel
getChannel()
TheStageChannel
for this stage instanceGuild
getGuild()
TheGuild
this stage instance is inStageInstanceManager
getManager()
TheStageInstanceManager
used to update this stage instance.StageInstance.PrivacyLevel
getPrivacyLevel()
TheStageInstance.PrivacyLevel
of this stage instancedefault List<Member>
getSpeakers()
All current speakers of this stage instance.String
getTopic()
The topic of this stage instanceboolean
isDiscoverable()
Deprecated.Stage discovery has been removed from the platform-
Methods inherited from interface net.dv8tion.jda.api.entities.ISnowflake
getId, getIdLong, getTimeCreated
-
-
-
-
Method Detail
-
getChannel
@Nonnull StageChannel getChannel()
TheStageChannel
for this stage instance- Returns:
- The
StageChannel
-
getPrivacyLevel
@Nonnull StageInstance.PrivacyLevel getPrivacyLevel()
TheStageInstance.PrivacyLevel
of this stage instance- Returns:
- The
StageInstance.PrivacyLevel
-
isDiscoverable
@Deprecated @ForRemoval @DeprecatedSince("5.0.0") boolean isDiscoverable()
Deprecated.Stage discovery has been removed from the platformWhether this stage instance can be found in stage discovery.- Returns:
- True if this is a public stage that can be found in stage discovery
-
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 theaudience
.Only
stage moderators
can promote or invite speakers. A stage moderator can move between speaker and audience at any time.
-
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 aspeaker
.Only
stage moderators
can promote or invite speakers. A stage moderator can move between speaker and audience at any time.
-
delete
@Nonnull @CheckReturnValue RestAction<Void> delete()
Deletes this stage instancePossible
ErrorResponses
include:UNKNOWN_STAGE_INSTANCE
If this stage instance is already deletedUNKNOWN_CHANNEL
If the channel was deleted
- Returns:
RestAction
- Throws:
InsufficientPermissionException
- If the self member is not astage moderator
-
getManager
@Nonnull @CheckReturnValue StageInstanceManager getManager()
TheStageInstanceManager
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 astage moderator
-
-