• Home
• org.jellyfin.sdk
• jellyfin-api-jvm
• 1.5.4
• source code
• SocketConnection.kt

×

Project download

Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance.
Project price only 1 $

You can buy this project and download/modify it how often you want.

commonMain.org.jellyfin.sdk.api.sockets.SocketConnection.kt Maven / Gradle / Ivy

package org.jellyfin.sdk.api.sockets

import kotlinx.coroutines.flow.StateFlow

/**
 * Reusable WebSocket connection. Constructed using [SocketConnectionFactory].
 */
public interface SocketConnection {
	/**
	 * State of the connection. Includes received messages.
	 */
	public val state: StateFlow

	/**
	 * Connect to [url]. If there is an existing connection it should be automatically disconnected. After a connection
	 * is initialized the state should be updated until [disconnect] is called or the connection is closed by other
	 * means (server closed, network issues, new connect call etc.).
	 *
	 * @return true when connected, false when connection failed.
	 *
	 * @see disconnect
	 */
	public suspend fun connect(url: String, authorization: String): Boolean

	/**
	 * Send a message to this connection. Messages may be added to an internal queue and be slightly delayed.
	 * The implementation must enqueue messages send while still connecting.
	 *
	 * @return false when failed to send/queue. true when it's likely the message will be sent. It may still be possible
	 * that a message fails to send from a queue to the server.
	 */
	public suspend fun send(message: String): Boolean

	/**
	 * Disconnect the WebSocket. Will do nothing when there is no connection.
	 *
	 * @see connect
	 */
	public suspend fun disconnect()
}