Componente Presence — sgcHTML | eSeGeCe

Presence

TsgcHTMLComponent_Presence — uma lista de "quem está online", renderizada como uma pilha de avatares sobrepostos ou uma lista, com indicadores de status e atualizações ao vivo via WebSocket, em Delphi, C++ Builder e .NET.

TsgcHTMLComponent_Presence

Adicione usuários com AddUser, limite quantos aparecem com MaxVisible, então leia a propriedade HTML — ou envie uma mudança de status para os clientes abertos com GetUserFragmentHTML.

Classe do componente

TsgcHTMLComponent_Presence

Renderiza

Pilha de avatares ou lista, mais CSS com escopo

Família

Chat & IA

Linguagens

Delphi, C++ Builder, .NET

Adicione usuários, renderize, envie mudanças de status

Chame AddUser para cada pessoa, leia HTML para a renderização inicial e então chame SetUserStatus e envie GetUserFragmentHTML quando o status de alguém mudar.

uses
  sgcHTML_Component_Presence;

var
  oPresence: TsgcHTMLComponent_Presence;
begin
  oPresence := TsgcHTMLComponent_Presence.Create(nil);
  try
    oPresence.PresenceID := 'roster';
    oPresence.Layout := plAvatars;
    oPresence.MaxVisible := 5;
    oPresence.Title := 'Online';

    oPresence.AddUser('u1', 'Ana Torres', psOnline);
    oPresence.AddUser('u2', 'Marc Bell', psAway, '', 'Back at 3pm');
    oPresence.AddUser('u3', 'Kenji Ito', psBusy);

    WebModule.Response := oPresence.HTML;   // avatar stack + scoped CSS
  finally
    oPresence.Free;
  end;
end;

// Push a status change to every connected client, no full re-render:
oPresence.SetUserStatus('u2', psOnline);
TsgcHTMX_Engine_Server.BroadcastFragment(oPresence.GetUserFragmentHTML('u2'));
// includes: sgcHTML_Component_Presence.hpp

TsgcHTMLComponent_Presence *oPresence = new TsgcHTMLComponent_Presence(NULL);
try
{
  oPresence->PresenceID = "roster";
  oPresence->Layout = plAvatars;
  oPresence->MaxVisible = 5;
  oPresence->Title = "Online";

  oPresence->AddUser("u1", "Ana Torres", psOnline);
  oPresence->AddUser("u2", "Marc Bell", psAway, "", "Back at 3pm");
  oPresence->AddUser("u3", "Kenji Ito", psBusy);

  String html = oPresence->HTML;   // avatar stack + scoped CSS

  // Push a status change to every connected client:
  oPresence->SetUserStatus("u2", psOnline);
  TsgcHTMX_Engine_Server::BroadcastFragment(oPresence->GetUserFragmentHTML("u2"));
}
__finally
{
  delete oPresence;
}
using esegece.sgcWebSockets;

var presence = new TsgcHTMLComponent_Presence();
presence.PresenceID = "roster";
presence.Layout = TsgcHTMLPresenceLayout.plAvatars;
presence.MaxVisible = 5;
presence.Title = "Online";

presence.AddUser("u1", "Ana Torres", TsgcHTMLPresenceStatus.psOnline);
presence.AddUser("u2", "Marc Bell", TsgcHTMLPresenceStatus.psAway, "", "Back at 3pm");
presence.AddUser("u3", "Kenji Ito", TsgcHTMLPresenceStatus.psBusy);

string html = presence.HTML;   // avatar stack + scoped CSS

// Push a status change to every connected client, no full re-render:
presence.SetUserStatus("u2", TsgcHTMLPresenceStatus.psOnline);
TsgcHTMX_Engine_Server.BroadcastFragment(presence.GetUserFragmentHTML("u2"));

Principais propriedades & métodos

Os membros que você usa com mais frequência.

Adicionando usuários

AddUser(aId, aDisplayName, aStatus, aAvatarURL, aStatusText) insere ou atualiza uma entrada da lista: um Id existente é atualizado no local.

Status

TsgcHTMLPresenceStatuspsOnline, psAway, psBusy, psOffline. SetUserStatus(aId, aStatus, aStatusText) atualiza apenas o indicador e o texto de status.

Layout

Layout escolhe plAvatars (pilha de avatares sobrepostos) ou plList (linhas de nome + status); AvatarSize define o diâmetro do avatar em pixels.

Limite de estouro

MaxVisible (padrão 5) limita quantos usuários são exibidos antes de aparecer um chip "+N"; todo usuário permanece no markup para que um envio posterior ainda o encontre.

Cabeçalho

Title e ShowCount renderizam um cabeçalho com um badge de contagem online; GetOnlineCount exclui usuários psOffline.

Atualizações em streaming

GetUserFragmentHTML(aId) (também emite uma remoção quando RemoveUser é chamado), GetCountFragmentHTML e GetMoreFragmentHTML alimentam TsgcHTMX_Engine_Server.PushFragment / BroadcastFragment.

Continue explorando

Ajuda onlineReferência completa da API e guia de uso para este componente.
Todos os Componentes sgcHTMLExplore a matriz completa de recursos com mais de 80 componentes.
Baixar Versão de Avaliação GratuitaA avaliação de 30 dias inclui os projetos de demonstração 60.HTML.
PreçosLicenças Single, Team e Site com código-fonte completo.

Pronto para Começar?

Baixe a versão de avaliação gratuita e adicione uma lista de presença em tempo real à sua aplicação web Delphi, C++ Builder ou .NET.