@callback handle_connection_closed(state :: state()) :: state()

Callback invoked when the socket connection is terminated. In normal conditions, handle_delete_stream is called before this one. If delete_stream is not called and connection_closed is, it might just mean that the connection was lost (for instance when TCP socket is closed unexpectedly).

It is up to the users to determined how to handle it in their case.

@callback handle_data_available(payload :: binary(), state :: state()) :: state()

The callback invoked when new piece of data is received from a given client.

@callback handle_delete_stream(state :: state()) :: state()

Callback invoked when the RMTP stream is finished.

@callback handle_info(msg :: term(), state()) :: state()

The callback invoked when the client handler receives a message that is not recognized as an internal message of the client handler.

@callback handle_init(any()) :: state()

The callback invoked once the client handler is created. It should return the initial state of the client handler.

@callback handle_metadata(
  {:metadata_message,
   Membrane.RTMP.Messages.OnMetaData.t()
   | Membrane.RTMP.Messages.SetDataFrame.t()},
  state()
) :: state()

The optional callback invoked when the client handler receives RTMP message with metadata information (just like a resolution or a framerate of a video stream). The following messages are considered the ones that contain metadata:

1. OnMetaData
2. SetDataFrame