// Create a Core instance using the default configuration.
const core = new Core();
Static Readonly DEFAULT_Default configuration for common core settings.
-Static Readonly DEFAULT_Default configuration for stream settings.
-Retrieves the current configuration for the core instance, ensuring immutability.
+Static Readonly DEFAULT_Default configuration for common core settings.
+Static Readonly DEFAULT_Default configuration for stream settings.
+Retrieves the current configuration for the core instance, ensuring immutability.
A deep readonly version of the core configuration.
-Applies a set of dynamic configuration updates to the core, merging with the existing configuration.
+Applies a set of dynamic configuration updates to the core, merging with the existing configuration.
A set of configuration changes to apply.
// Example of dynamically updating the download time windows and timeout settings.
const dynamicConfig = {
httpDownloadTimeWindowMs: 60, // Set HTTP download time window to 60 seconds
p2pDownloadTimeWindowMs: 60, // Set P2P download time window to 60 seconds
httpNotReceivingBytesTimeoutMs: 1500, // Set HTTP timeout to 1500 milliseconds
p2pNotReceivingBytesTimeoutMs: 1500 // Set P2P timeout to 1500 milliseconds
};
core.applyDynamicConfig(dynamicConfig);
Adds an event listener for the specified event type on the core event target.
+Adds an event listener for the specified event type on the core event target.
The name of the event to listen for.
The callback function to invoke when the event is fired.
-Removes an event listener for the specified event type on the core event target.
+Removes an event listener for the specified event type on the core event target.
The name of the event to listen for.
The callback function to be removed.
-Retrieves a specific stream by its runtime identifier, if it exists.
+Retrieves a specific stream by its runtime identifier, if it exists.
The runtime identifier of the stream to retrieve.
The stream with its segments, or undefined if not found.
Ensures a stream exists in the map; adds it if it does not.
+Ensures a stream exists in the map; adds it if it does not.
The stream to potentially add to the map.
-Updates the segments associated with a specific stream.
The runtime identifier of the stream to update.
Optional addSegments: Iterable<Segment>Optional segments to add to the stream.
Optional removeSegmentIds: Iterable<string>Optional segment IDs to remove from the stream.
-Loads a segment given its runtime identifier and invokes the provided callbacks during the process. Initializes segment storage if it has not been initialized yet.
The runtime identifier of the segment to load.
The callbacks to be invoked during segment loading.
Identify if a segment is loadable by the P2P core based on the segment's stream type and configuration.
+Identify if a segment is loadable by the P2P core based on the segment's stream type and configuration.
Segment runtime identifier to check.
true if the segment is loadable by the P2P core, otherwise false.
Cleans up resources used by the Core instance, including destroying any active stream loaders +
Custom error class for errors that occur during core network requests.
-Constructs a new CoreRequestError.
The type of the error, either 'failed' or 'aborted'.
-Readonly typeThe type of the error, either 'failed' or 'aborted'.
-Represents an error that can occur during the request process, with a timestamp for when the error occurred.
The specific type of request error.
-Constructs a new RequestError.
The specific error type.
Optional message: stringOptional message describing the error.
-Readonly timestampError timestamp.
-Readonly typeThe specific error type.
-Represents a range of bytes, used for specifying a segment of data to download.
The starting byte index of the range.
The ending byte index of the range.
-The CoreEventMap defines a comprehensive suite of event handlers crucial for monitoring and controlling the lifecycle +
The CoreEventMap defines a comprehensive suite of event handlers crucial for monitoring and controlling the lifecycle of segment downloading and uploading processes.
Invoked when a segment is fully downloaded and available for use.
Contains information about the loaded segment.
@@ -167,14 +167,22 @@Fired at the beginning of a segment download process.
Provides details about the segment being downloaded.
Occurs when a new peer-to-peer connection is established.
-Triggered when an existing peer-to-peer connection is closed.
-Invoked after a chunk of data from a segment has been successfully downloaded.
-The size of the downloaded chunk in bytes.
+Contains details about the peer that the event is about.
+Triggered when an existing peer-to-peer connection is closed.
+Contains details about the peer that the event is about.
+Triggered when an error occurs during a peer-to-peer connection.
+Contains details about the error and the peer that the event is about.
+Invoked after a chunk of data from a segment has been successfully downloaded.
+The size of the downloaded chunk in bytes.
Optional peerId: stringThe peer ID of the peer that the event is about, if applicable.
Called when a chunk of data has been successfully uploaded to a peer.
-The length of the segment in bytes.
+The length of the segment in bytes.
The peer ID, if the segment was downloaded from a peer
-Represents a defined Core configuration with specific settings for the main and secondary streams.
Configuration for the main stream.
Configuration for the secondary stream.
-Specifies the source of a download within a media streaming context.
"http" - Indicates that the segment was downloaded using the HTTP protocol.
"p2p"- Indicates that the segment was downloaded through a peer-to-peer network.
-Represents a set of properties that can be dynamically modified at runtime.
-Defines the types of errors specific to HTTP requests.
-Represents the details of a peer in a peer-to-peer network.
+Represents the details of a peer in a peer-to-peer network.
The unique identifier for a peer in the network.
-Represents the details of a peer error event.
+The unique identifier for a peer in the network.
+The type of stream that the peer is connected to.
+The error that occurred during the peer-to-peer connection.
+
Core class for managing media streams loading via P2P.
-