Skip to content

armgit / Piik

Public Imported from GitHub
0

Free, open-source screen sharing for private live streams with friends. Watch together in a browser or self-host Piik. 免费开源的私密屏幕共享,支持游戏直播、一起看电影与自部署。

8.2 KB
Raw Blame
import type { ConnectionMetrics } from "../../types";
import { formatPacketLossPercent } from "../connection-details";
import { Glyph } from "../../ui/icons";
import { useCopy } from "../../ui/copy";
import { PawnSvg } from "./Pawn";
import { participantColor } from "./participant-color";
import type { StatusDescriptor } from "../../ui/media-status";
import { Tooltip } from "./Tooltip";
import { METRIC_PRESENTATION, metricHintText, type MetricLabel } from "./metric-presentation";
import type { RoomVoiceSnapshot } from "../../room-voice/session";
import { describeVoiceConnection, voiceMetricsForPeer } from "../../room-voice/VoiceConnectionDetails";
import type { VoiceConnectionMetric } from "../../room-voice/browser-endpoint";

export interface ViewerOverviewEntry {
  key: string;
  name: string;
  status: StatusDescriptor;
  route: "p2p" | "sfu" | null;
  metrics: ConnectionMetrics | null;
}

function finite(value: number | null): value is number {
  return value !== null && Number.isFinite(value);
}

export function ViewerOverview({
  entries,
  selectedKey,
  onSelect,
  pictureActive,
  voice,
  voiceMetrics = [],
}: {
  entries: readonly ViewerOverviewEntry[];
  selectedKey: string | null;
  onSelect: (key: string) => void;
  pictureActive: boolean;
  voice?: RoomVoiceSnapshot | null;
  voiceMetrics?: readonly VoiceConnectionMetric[];
}) {
  const { t, vis } = useCopy();
  const voiceActive = voice?.room?.enabled === true;
  const unknown = vis ? "—" : t("stats.unknown");
  const numberValue = (
    value: number | null | undefined,
    digits: number,
    unit = "",
  ): string =>
    finite(value ?? null) ? `${value!.toFixed(digits)}${unit}` : unknown;
  const heading = (key: MetricLabel) => (
    <Tooltip toggleOnClick kind={METRIC_PRESENTATION[key].hint} text={vis ? undefined : metricHintText(key, t)}>
      <button type="button" aria-label={t(key)} style={{ border: 0, padding: 0, background: "none", color: "inherit", font: "inherit" }}>
        {vis ? <Glyph name={METRIC_PRESENTATION[key].icon} size={14} /> : t(key)}
      </button>
    </Tooltip>
  );

  return (
    <section
      className={`lr-viewer-overview${pictureActive ? " has-picture" : ""}${voiceActive ? " has-voice" : ""}`}
      id="host-viewer-overview"
      aria-label={t("host.viewerOverview")}
    >
      <div className="lr-viewer-overview-scroll">
        <div className="lr-viewer-overview-head">
          <span>{vis ? <Glyph name="users" size={14} /> : t("common.viewers")}</span>
          {pictureActive && <>
          <span>{vis ? <Glyph name="tv" size={14} /> : t("host.settings.picture")}</span>
          {heading("stats.resolution")}
          {heading("stats.fps")}
          {heading("stats.bitrate")}
          {heading("stats.loss")}
          {heading("stats.rtt")}
          </>}
          {voiceActive && <span>{vis ? <Glyph name="headphones" size={14} /> : t(pictureActive ? "voice.details.title" : "voice.details.receive")}</span>}
          {voiceActive && !pictureActive && <>
            {heading("stats.audio")}{heading("stats.rtt")}{heading("stats.audioLoss")}{heading("stats.audioJitter")}
          </>}
        </div>
        <div className="lr-viewer-overview-body">
          {entries.map((entry) => {
            const statusLabel = t(entry.status.labelKey);
            const hint = entry.status.tooltip ?? entry.status.comic;
            const metrics = entry.metrics;
            const resolution = metrics?.resolution ?? unknown;
            const fps = numberValue(metrics?.framesPerSecond, 1, " fps");
            const bitrate = numberValue(metrics?.bitrateKbps, 0, " kbps");
            const loss = metrics
              ? formatPacketLossPercent(metrics.packetLossPercent, unknown)
              : unknown;
            const rtt = numberValue(metrics?.rttMs, 0, " ms");
            const voiceDetail = describeVoiceConnection(voice, entry.key);
            const voiceObservation = voiceMetricsForPeer(voiceMetrics, entry.key).find(item => item.direction === "receive");
            const voiceSample = voiceObservation?.metrics;
            const voiceLabel = t(voiceDetail?.status.labelKey ?? "voice.outside");
            const voiceRoute = voiceObservation?.route.toUpperCase() ?? (voiceDetail?.upstream.kind === "peer" ? "P2P" : voiceDetail?.upstream.kind === "sfu" ? "SFU" : null);
            const route =
              entry.route === "sfu"
                ? "SFU"
                : entry.route === "p2p"
                  ? "P2P"
                  : "—";
            const row = (
              <button
                type="button"
                className={`lr-viewer-overview-row${selectedKey === entry.key ? " is-selected" : ""}`}
                aria-pressed={selectedKey === entry.key}
                aria-label={[entry.name, statusLabel, pictureActive ? route : null,
                  voiceActive ? `${t("voice.details.title")} · ${voiceRoute ?? voiceLabel}` : null].filter(Boolean).join(" · ")}
                onClick={() => onSelect(entry.key)}
              >
                <span className="lr-viewer-overview-person">
                  <span className="lr-viewer-overview-pawn">
                    <PawnSvg color={participantColor(entry.key)} identity={entry.key} />
                    <i className="lr-pawn-led" data-tone={entry.status.tone}
                      data-pulse={entry.status.pulse || undefined} aria-hidden="true" />
                  </span>
                  <span className="lr-viewer-overview-person-copy">
                    <b>{entry.name}</b>
                    {vis ? null : <small>{statusLabel}</small>}
                  </span>
                </span>
                {pictureActive && <><span className={`lr-viewer-overview-route is-${entry.route ?? "pending"}`}>
                  <Glyph
                    name={
                      entry.route === "sfu"
                        ? "server"
                        : entry.route === "p2p"
                          ? "network"
                          : "loader"
                    }
                    size={14}
                  />
                  {vis ? (
                    <span className="visually-hidden">
                      {t(
                        entry.route === "sfu"
                          ? "state.route.sfu"
                          : entry.route === "p2p"
                            ? "state.route.p2p"
                            : "state.peer.connecting",
                      )}
                    </span>
                  ) : (
                    <b>{route}</b>
                  )}
                </span>
                <span>{resolution}</span>
                <span>{fps}</span>
                <span>{bitrate}</span>
                <span>{loss}</span>
                <span>{rtt}</span>
                </>}
                {voiceActive && <span className="lr-viewer-overview-voice" data-tone={voiceDetail?.status.tone ?? "off"}>
                  <Glyph name={voiceDetail?.status.icon ?? "headphonesOff"} size={14} />
                  <span><b className={!voiceRoute && vis ? "visually-hidden" : undefined}>{voiceRoute ?? voiceLabel}</b>
                    {voiceRoute && <small className={vis ? "visually-hidden" : undefined}>{voiceLabel}</small>}
                  </span>
                </span>}
                {voiceActive && !pictureActive && <>
                  <span>{numberValue(voiceSample?.bitrateKbps, 0, " kbps")}</span>
                  <span>{numberValue(voiceSample?.rttMs, 0, " ms")}</span>
                  <span>{formatPacketLossPercent(voiceSample?.packetLossPercent ?? null, unknown)}</span>
                  <span>{numberValue(voiceSample?.jitterMs, 1, " ms")}</span>
                </>}
              </button>
            );
            return (
              <Tooltip
                key={entry.key}
                className="lr-overview-row-hint"
                kind={hint}
                tone={entry.status.tone}
                motion={entry.status.pulse ? "progress" : undefined}
                text={vis ? undefined : statusLabel}
                overflow={{ text: entry.name, selector: ".lr-viewer-overview-person-copy > b" }}
                align="start"
              >
                {row}
              </Tooltip>
            );
          })}
        </div>
      </div>
    </section>
  );
}