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. 免费开源的私密屏幕共享,支持游戏直播、一起看电影与自部署。

1.6 KB
Raw Blame
package route

import (
	"strconv"

	"github.com/TNTcraftHIM/Piik/internal/server/protocol"
)

// debugCandidate is the `{route, transition}` item of "operation-started".
type debugCandidate struct {
	Route      string
	Transition TransitionKind
}

func (c *Controller) debugEnabled() bool {
	return c.debugLog != nil && c.debugRoomID != ""
}

// debug emits one sanitized event with a diagnostic room ID and current facts.
// Never pass raw peer IDs, session IDs or connection IDs; use debugPeer and
// debugTuple. The effect layer injects the sink and owns its enabling policy.
func (c *Controller) debug(event string, details ...any) {
	if !c.debugEnabled() {
		return
	}
	args := make([]any, 0, 8+len(details))
	args = append(args,
		"event", event,
		"roomId", c.debugRoomID,
		"revision", c.revision,
		"factVersion", c.factVersion)
	args = append(args, details...)
	c.debugLog("piik-route", args...)
}

// debugPeer returns "host", "viewer-<joinOrder>" or "viewer-unknown".
func (c *Controller) debugPeer(peerID string) string {
	current, _ := c.participants.Get(peerID)
	if peerID == c.hostPeerID || (current != nil && current.role == protocol.RoleHost) {
		return "host"
	}
	if current == nil {
		return "viewer-unknown"
	}
	return "viewer-" + strconv.FormatInt(current.joinOrder, 10)
}

// debugTuple returns "p2p:<label>[:regenerate]" or "sfu:<publication>".
func (c *Controller) debugTuple(tuple CandidateTuple) string {
	if tuple.Kind == UpstreamPeer {
		label := "p2p:" + c.debugPeer(tuple.ParentPeerID)
		if tuple.Regenerate {
			label += ":regenerate"
		}
		return label
	}
	return "sfu:" + string(tuple.Publication)
}