Skip to content

[DOCS]: Add documention for model classes#144

Open
Doominika wants to merge 32 commits intodocs/prepare-inline-documentation-for-streamsfrom
docs/add-documention-for-model-classes
Open

[DOCS]: Add documention for model classes#144
Doominika wants to merge 32 commits intodocs/prepare-inline-documentation-for-streamsfrom
docs/add-documention-for-model-classes

Conversation

@Doominika
Copy link
Copy Markdown
Contributor

Description

Add inline documentation to the stream models.

…lasses' into docs/add-documention-for-model-classes
@Doominika Doominika requested a review from djenczewski April 16, 2026 12:42

/**
* Indicates active speech detection on the track
*/
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

delete this field

public String streamRoomId;

/**
* Identifier of the stream that was left
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe like this:

Suggested change
* Identifier of the stream that was left
* Published stream identifier of the user who left

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Identifier of the stream that the user left?

*/
public String lastModifier;
/**
* List of usernames with access to the stream room
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* List of usernames with access to the stream room
* List of user's IDs with access to the stream room

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • IDs of users with access to the stream room.

*/
public List<String> users;
/**
* List of usernames with management privileges over the stream room
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* List of usernames with management privileges over the stream room
* List of user's IDs with management privileges over the stream room

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • IDs of users with management rights in the stream room.

@djenczewski djenczewski requested review from filipg43 and zurekz April 24, 2026 12:55
@Doominika Doominika requested a review from djenczewski April 24, 2026 13:32
public String room;

/**
* List of newly available streams that can be subscribed to
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

List of new streams that can be subscribed.

import java.util.List;

/**
* Data describing the event that occurs when new streams become available for subscription in a stream room.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Data describing event triggered when there are new streams available in stream room.

* Constructs a new {@link NewStreams} instance.
*
* @param room Identifier of the stream room
* @param streams List of newly available streams that can be subscribed to
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

List of new streams that can be subscribed.

import java.util.List;

/**
* Data describing the event that occurs when a participant joins a StreamRoom.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Data describing event that triggers when a participant joins a StreamRoom.

import java.util.List;

/**
* Data describing the event that occurs when a participant leaves a StreamRoom.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Data describing event that triggers when a user leaves a StreamRoom.

* @param type Type of the track (e.g. "audio", "video", "data")
* @param mindex
* @param mid
* @param disabled Indicates if the track is disabled
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Whether the track is disabled.

* @param type Type of the track (e.g. "audio", "video", "data")
* @param mindex
* @param mid
* @param disabled Indicates if the track is disabled
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Whether the track is disabled.

* @param codec Codec used by the track (e.g. "opus", "VP8")
* @param description Description of the track
* @param moderated
* @param simulcast Indicates if simulcast is enabled for the track
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Whether simulcast is enabled for the track

* @param type Type of the track (e.g. "audio", "video", "data")
* @param mindex
* @param mid
* @param disabled Indicates if the track is disabled
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Whether the track is disabled.

* @param codec Codec used by the track (e.g. "opus", "VP8")
* @param description Description of the track
* @param moderated
* @param simulcast Indicates if simulcast is enabled for the track
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Whether simulcast is enabled for the track.

/**
* Defines the types of events that can occur within the stream for which a client can subscribe.
* This enum lists the various actions or changes that can happen to
* stream rooms and their streams, allowing observers to be notified of specific occurrences.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • Event types that clients can subscribe to within a stream room.
  • Covers state changes across stream rooms and their individual streams.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

or:

  • Subscribable event types for stream rooms and their streams.

*/
EMPTY,
/**
* Type of event triggered when a participant joins a StreamRoom.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

 * Type of event triggered when a user joins a StreamRoom.

*/
STREAM_JOIN,
/**
* Type of event triggered when a participant leaves a StreamRoom.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

 * Type of event triggered when a user leaves a StreamRoom.

*/
STREAM_LEAVE,
/**
* Type of event triggered when a participant starts publishing a stream.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

 * Type of event triggered when a user starts publishing a stream.

*/
STREAM_PUBLISH,
/**
* Type of event triggered when a participant stops publishing a stream.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

 * Type of event triggered when a user stops publishing a stream.

import java.util.List;

/**
* Data received when a new participant joins the StreamRoom.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • Data received when a new user joins the StreamRoom.

/**
* Defines the types of events that can occur within the stream for which a client can subscribe.
* This enum lists the various actions or changes that can happen to
* stream rooms and their streams, allowing observers to be notified of specific occurrences.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

or:

  • Subscribable event types for stream rooms and their streams.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants