How do I handle the Server Connection Events?
The Server object can deliver events to your application about the state of connection to the Server.
This allows client applications to relay to the user issues with connectivity.
Prerequisite: This example requires a Server and the client to be registered as listener
For complete examples refer to the sample applications that come with the DecoderSDK.
Example
Register for the listener
// Register to receive IServerListener callbacks
server->RegisterListener(this);
Retrieve call backs on the listener
// IServerListener callbacks
//The Server has changed stare
void GeneralSample::ServerStateChanged( ServerLinkState state )
{
printf("Server state changed = %d\r\n",state);
if (state == SL_Connected)
{
//The server has connected
}
}
// There has been a server error
void ServerError( ServerLinkError error )
{
printf("Server ERROR = %d\r\n",error);
}
// An Encoders information has been updated
void EncoderInfoUpdated(const EncoderUpdateInfo eventInfo,const Encoder encoder)
{
std::wstring params;
for (int i = 0; i < eventInfo.ParamKeys().size(); i++)
{
if (params.length() > 0)
{
params.append(L", ");
}
params.append(eventInfo.ParamKeys().at(i));
}
wcout << L"Updated Encoder " << encoder.Name() << L" " << params << L"\n";
}
// An Encoder has connected
void EncoderConnected(const Encoder encoder)
{
wcout << L"Connected Encoder " << encoder.Name() << L"\n";
long long last_seen = encoder.LastConnectDisconnectTime();
if (last_seen > 0)
{
wcout << L" Last connect disconnect time = " << to_wstring(last_seen) << endl;
}
}
// An Encoder has disconnected
void EncoderDisconnected(const Encoder encoder)
{
wcout << L"Disconnected Encoder " << encoder.Name() << L"\n";
long long last_seen = encoder.LastConnectDisconnectTime();
if (last_seen > 0)
{
wcout << L" Last connect disconnect time = " << to_wstring(last_seen) << endl;
}
}
Register for the listener
// Register to receive IServerListener callbacks
ServerListener _serverListener = new ServerListener();
_server.RegisterListener(_serverListener);
Retrieve call backs on the listener
public class ServerListener : IServerListener
{
{
Console.WriteLine("Server state changed - {0}", status.ToString());
switch (status)
{
case ServerLinkState.SL_Disconnected:
// all communication with the server is lost now
// no streams will be accessible
break;
case ServerLinkState.SL_Connected:
// in the event of a server connect the encoders list should be repopulated
// if the server has temporarily disconnected then reconnected, any streams that
// were in use before the disconnect must be re-requested.
break;
case ServerLinkState.SL_Connecting:
// an attempt to restore communication with the server
// is in progress. If successful this method will be called again
// with SL_Connected. If unsuccessful this method will be called
// again with SL_Disconnected.
break;
}
}
{
// This method is calld in the event of an unrecoverable error on the current server session.
// The server must be disconencted and a new session established by calling Connect
// or ConnectSecure.
Console.WriteLine("Server error - {0}", error.ToString());
}
public override void EncoderInfoUpdated(EncoderUpdateInfo eventInfo, EdgeVisDecoderSDK.Encoder encoder)
{
// The encoder list for the current server has updated information for the specified
// encoder. For example, this information may be location, sleep settings or timezone.
if (eventInfo != null)
{
ParamsMap pars = eventInfo.Params();
if (pars != null)
{
foreach (var p in pars)
{
Console.WriteLine("{0} - {1}", p.Key, p.Value);
}
}
}
Console.WriteLine("Updated Encoder {0}", encoder.Name());
}
{
// This method informs us that the encoder specified has connected to the server.
// At this point it can be determined which features the encoder supports and its
// streams and services can be accessed.
// Note that the calling thread should not be blocked or have excessive processing
// executing as this will have a detrimental effect on the media stream.
Console.WriteLine("Connected Encoder {0}", encoder.Name());
long lastSeen = encoder.LastConnectDisconnectTime();
if (lastSeen > 0)
{
Console.WriteLine("Last connect disconnect time = {0}", lastSeen.ToString());
}
}
{
// This method informs us that the encoder specified has disconnected from the server.
// At this point it can no longer be determined which features the encoder supports,
// nor the streams and services that the encoder can provide when it is connected.
// Note that the calling thread should not be blocked or have excessive processing
// executing as this will have a detrimental effect on the media stream.
Console.WriteLine("Disconnected Encoder {0}", encoder.Name());
long lastSeen = encoder.LastConnectDisconnectTime();
if (lastSeen > 0)
{
Console.WriteLine("Last connect disconnect time = {0}", lastSeen);
}
}
{
// This method provides an indication that the specified encoder has been in sleep
// and has failed to contact the server at the expected time.
// This could indicate a power failure, lack of comms connectivity or hardware
// problem at the encoder.
Console.WriteLine("Encoder Overslept {0}", encoder.Name());
}
}
Register for the listener
// Register to receive IServerListener callbacks
ServerListener _serverListener = new ServerListener();
_server.RegisterListener(_serverListener);
Retrieve call backs on the listener
private class SDKServerListener extends IServerListener {
@Override
if(status == null) return;
Log.i(TAG,"Server state changed - " + status.toString());
if (status.toString().equals(SL_Connected.toString()))
{
// in the event of a server connect the encoders list should be repopulated
// if the server has temporarily disconnected then reconnected, any streams that
// were in use before the disconnect must be re-requested.
}
{
// all communication with the server is lost now
// no streams will be accessible
}
{
// an attempt to restore communication with the server
// is in progress. If successful this method will be called again
// with SL_Connected. If unsuccessful this method will be called
// again with SL_Disconnected.
}
}
@Override
// This method is calld in the event of an unrecoverable error on the current server session.
// The server must be disconencted and a new session established by calling Connect
// or ConnectSecure.
Log.i(TAG,"Server error - " + error.toString());
}
@Override
public void EncoderInfoUpdated(EncoderUpdateInfo eventInfo, Encoder encoder) {
// The encoder list for the current server has updated information for the specified
// encoder. For example, this information may be location, sleep settings or timezone.
StringBuilder params = new StringBuilder("");
for (int i = 0; i < eventInfo.ParamKeys().size(); i++)
{
if (params.length() > 0)
{
params.append(", ");
}
params.append(eventInfo.ParamKeys().get(i));
}
Log.i(TAG,"Updated Encoder " + encoder.Name() + " " + params);
}
@Override
public void EncoderConnected(Encoder encoder) {
// This method informs us that the encoder specified has connected to the server.
// At this point it can be determined which features the encoder supports and its
// streams and services can be accessed.
// Note that the calling thread should not be blocked or have excessive processing
// executing as this will have a detrimental effect on the media stream.
Log.i(TAG,"Connected Encoder " + encoder.Name());
long last_seen = encoder.LastConnectDisconnectTime();
if (last_seen > 0)
{
Log.i(TAG," Last connect disconnect time = " + last_seen);
}
}
@Override
public void EncoderDisconnected(Encoder encoder) {
// This method informs us that the encoder specified has disconnected from the server.
// At this point it can no longer be determined which features the encoder supports,
// nor the streams and services that the encoder can provide when it is connected.
// Note that the calling thread should not be blocked or have excessive processing
// executing as this will have a detrimental effect on the media stream.
Log.i(TAG,"Disconnected Encoder " + encoder.Name());
long last_seen = encoder.LastConnectDisconnectTime();
if (last_seen > 0)
{
Log.i(TAG," Last connect disconnect time = " + last_seen);
}
}
@Override
public void EncoderOverslept(Encoder encoder) {
// This method provides an indication that the specified encoder has been in sleep
// and has failed to contact the server at the expected time.
// This could indicate a power failure, lack of comms connectivity or hardware
// problem at the encoder.
Log.i(TAG,"Encoder Overslept " + encoder.Name());
}
}