Pull in Blackmagic recording functionality from Sunset Showdown branch and tidy it up.

Author: patfair

field/arena.go

@@ -55,6 +55,7 @@ type Arena struct {
 	Plc              plc.Plc
 	TbaClient        *partner.TbaClient
 	NexusClient      *partner.NexusClient
+	BlackmagicClient *partner.BlackmagicClient
 	AllianceStations map[string]*AllianceStation
 	Displays         map[string]*Display
 	TeamSigns        *TeamSigns
@@ -182,6 +183,7 @@ func (arena *Arena) LoadSettings() error {
 	arena.Plc.SetAddress(settings.PlcAddress)
 	arena.TbaClient = partner.NewTbaClient(settings.TbaEventCode, settings.TbaSecretId, settings.TbaSecret)
 	arena.NexusClient = partner.NewNexusClient(settings.TbaEventCode)
+	arena.BlackmagicClient = partner.NewBlackmagicClient(settings.BlackmagicAddresses)
 
 	game.MatchTiming.WarmupDurationSec = settings.WarmupDurationSec
 	game.MatchTiming.AutoDurationSec = settings.AutoDurationSec
@@ -459,6 +461,7 @@ func (arena *Arena) AbortMatch() error {
 	arena.AudienceDisplayModeNotifier.Notify()
 	arena.AllianceStationDisplayMode = "logo"
 	arena.AllianceStationDisplayModeNotifier.Notify()
+	go arena.BlackmagicClient.StopRecording()
 	return nil
 }
 
@@ -550,6 +553,7 @@ func (arena *Arena) Update() {
 		arena.AudienceDisplayModeNotifier.Notify()
 		arena.AllianceStationDisplayMode = "match"
 		arena.AllianceStationDisplayModeNotifier.Notify()
+		go arena.BlackmagicClient.StartRecording()
 		if game.MatchTiming.WarmupDurationSec > 0 {
 			arena.MatchState = WarmupPeriod
 			enabled = false
@@ -601,6 +605,7 @@ func (arena *Arena) Update() {
 			auto = false
 			enabled = false
 			sendDsPacket = true
+			go arena.BlackmagicClient.StopRecording()
 			go func() {
 				// Leave the scores on the screen briefly at the end of the match.
 				time.Sleep(time.Second * matchEndScoreDwellSec)

model/event_settings.go

@@ -44,6 +44,7 @@ type EventSettings struct {
 	TeamSignBlue2Address            string
 	TeamSignBlue3Address            string
 	TeamSignBlueTimerAddress        string
+	BlackmagicAddresses             string
 	WarmupDurationSec               int
 	AutoDurationSec                 int
 	PauseDurationSec                int

partner/blackmagic.go

@@ -0,0 +1,62 @@
+// Copyright 2024 Team 254. All Rights Reserved.
+// Author: pat@patfairbank.com (Patrick Fairbank)
+//
+// Client for interfacing with one or more Blackmagic HyperDeck devices to automatically record matches.
+
+package partner
+
+import (
+	"fmt"
+	"log"
+	"net"
+	"strings"
+	"time"
+)
+
+const (
+	blackmagicPort             = 9993
+	blackmagicConnectTimeoutMs = 100
+	blackmagicStopDelaySec     = 10
+)
+
+type BlackmagicClient struct {
+	deviceAddresses []string
+}
+
+// Creates a new Blackmagic client with the given device addresses as a comma-separated string.
+func NewBlackmagicClient(addresses string) *BlackmagicClient {
+	deviceAddresses := strings.Split(addresses, ",")
+	for i, address := range deviceAddresses {
+		deviceAddresses[i] = strings.TrimSpace(address)
+	}
+	return &BlackmagicClient{deviceAddresses: deviceAddresses}
+}
+
+// Starts recording across all devices.
+func (client *BlackmagicClient) StartRecording() {
+	client.sendCommand("record")
+}
+
+// Stops recording across all devices after a delay.
+func (client *BlackmagicClient) StopRecording() {
+	time.Sleep(blackmagicStopDelaySec * time.Second)
+	client.sendCommand("stop")
+}
+
+// Connects to all devices and executes the given command.
+func (client *BlackmagicClient) sendCommand(command string) {
+	for _, address := range client.deviceAddresses {
+		conn, err := net.DialTimeout(
+			"tcp", fmt.Sprintf("%s:%d", address, blackmagicPort), blackmagicConnectTimeoutMs*time.Millisecond,
+		)
+		if err != nil {
+			log.Printf("Failed to connect to Blackmagic device at %s: %v", address, err)
+			continue
+		}
+		defer conn.Close()
+		_, err = fmt.Fprint(conn, command+"\n")
+		if err != nil {
+			log.Printf("Failed to send '%s' command to Blackmagic device at %s: %v", command, address, err)
+		}
+	}
+}

templates/setup_settings.html

@@ -291,6 +291,20 @@
             </div>
           </div>
         </fieldset>
+        <fieldset class="mb-4">
+          <legend>Match Video Recording</legend>
+          <p>
+            If you are using a Blackmagic HyperDeck device to record match video, enter the device IP address(es) here
+            to have Cheesy Arena automatically start and stop recording for each match. Separate multiple addresses with
+            a comma.
+          </p>
+          <div class="row mb-3">
+            <label class="col-lg-6 control-label">Blackmagic Addresses</label>
+            <div class="col-lg-6">
+              <input type="text" class="form-control" name="blackmagicAddresses" value="{{.BlackmagicAddresses}}">
+            </div>
+          </div>
+        </fieldset>
         <fieldset class="mb-4">
           <legend>Game-Specific</legend>
           <div class="row mb-3">

web/setup_settings.go

@@ -96,6 +96,7 @@ func (web *Web) settingsPostHandler(w http.ResponseWriter, r *http.Request) {
 	eventSettings.TeamSignBlue2Address = r.PostFormValue("teamSignBlue2Address")
 	eventSettings.TeamSignBlue3Address = r.PostFormValue("teamSignBlue3Address")
 	eventSettings.TeamSignBlueTimerAddress = r.PostFormValue("teamSignBlueTimerAddress")
+	eventSettings.BlackmagicAddresses = r.PostFormValue("blackmagicAddresses")
 	eventSettings.WarmupDurationSec, _ = strconv.Atoi(r.PostFormValue("warmupDurationSec"))
 	eventSettings.AutoDurationSec, _ = strconv.Atoi(r.PostFormValue("autoDurationSec"))
 	eventSettings.PauseDurationSec, _ = strconv.Atoi(r.PostFormValue("pauseDurationSec"))