NetStats PacketLossPercent

From SA-MP Wiki

Jump to: navigation, search

NetStats_PacketLossPercent

NetStats PacketLossPercent was added in SA-MP 0.3z This function was added in SA-MP 0.3z and will not work in earlier versions!


Image:32px-Ambox_warning_orange.png

Note

  • This function has been found to be currently unreliable the output is not as expected when compared to the client. Therefore this function should not be used as a packet loss kicker.


Description:

Gets the packet loss percentage of a player. Packet loss means data the player is sending to the server is being lost (or vice-versa).


Parameters:
(playerid)
playeridThe ID of the player to get the data from.


Return Values:

The percentage packet loss as a float. 0 if player not connected.


Example Usage:

public OnPlayerCommandText(playerid,cmdtext[])
{    
    if(!strcmp(cmdtext, "/packetloss"))
    {
        new szString[144];
        format(szString, sizeof(szString), "Packets lost: %.2f percent.", NetStats_PacketLossPercent(playerid));
        SendClientMessage(playerid, -1, szString);
    }
    return 1;
}
Tip

Image:Light_bulb_icon.png

Anything greater than 0.0% should already be a cause of concern. Anything greater than 1.0% is outright bad.


Related Functions

The following functions may be useful, as they are related to this function in one way or another.

  • GetNetworkStats: Gets the servers networkstats and saves it into a string.


  • NetStats_BytesReceived: Get the amount of information (in bytes) that the server has received from the player.
  • NetStats_BytesSent: Get the amount of information (in bytes) that the server has sent to the player.
Personal tools