Neuen Displays automatisch ein Programm geben

Am Ende bekommt jedes neue Display von selbst das Programm seines Standorts, wenige Sekunden nachdem es in der Flotte erscheint. Zieht ein Display an einen anderen Standort um, übernimmt es dessen Programm. Nach einem Rollout muss niemand mehr daran denken, Inhalte zuzuweisen.

So funktioniert es#

Der Empfänger führt eine Tabelle, welcher Standort welches Programm bekommt, dazu eine Vorgabe für Displays ohne Standort.

Schritte#

1. Schreiben Sie die Tabelle aus Standorten und Programmen als JSON auf. Die Standort-Kennungen liefert GET /v1/locations, die Programm-Kennungen stehen in der Portal-Adresse:

   JSONKopieren

   {  "loc_01KFB7QPW0LOCATION00000001": "sch_01KWVAFRM0ZETPAN0000000001",  "loc_01KFB7QPW0LOCATION00000002": "sch_01KWVAFRM0ZETPAN0000000002",  "default": "sch_01KWVAFRM0ZETPAN0000000003"}

2. Speichern Sie den Empfänger:

   TypeScriptKopieren

   // auto-assign.ts: node auto-assign.tsimport { createServer } from 'node:http';import { createHmac, timingSafeEqual } from 'node:crypto';import { readFileSync } from 'node:fs'; const SECRET = process.env.WEBHOOK_SECRET ?? ''; // whsec_…const API = process.env.SZENERA_API;const KEY = process.env.SZENERA_API_KEY; // fleet.player.read und schedule.updateconst PROGRAMS: Record<string, string> = JSON.parse(readFileSync('programs.json', 'utf8'));const seen = new Set<string>(); function isFromSignage(rawBody: string, header: string): boolean {  const expected = createHmac('sha256', SECRET).update(rawBody).digest('base64url');  const a = Buffer.from(expected);  const b = Buffer.from(header);  return a.length === b.length && timingSafeEqual(a, b);} async function call(method: string, path: string, body?: unknown) {  const res = await fetch(`${API}${path}`, {    method,    headers: { Authorization: `Bearer ${KEY}`, 'Content-Type': 'application/json' },    body: body === undefined ? undefined : JSON.stringify(body),  });  if (!res.ok) throw new Error(`${method} ${path}: ${res.status} ${await res.text()}`);  return res.json();} async function assignProgramOfLocation(playerId: string): Promise<void> {  const { player } = await call('GET', `/v1/players/${playerId}`);  const scheduleId = PROGRAMS[player.locationId ?? ''] ?? PROGRAMS.default;  if (!scheduleId) return;  await call('PUT', `/v1/players/${playerId}/program`, {    program: { kind: 'schedule', scheduleId },  });  console.log(`${player.name}: ${scheduleId}`);} createServer((req, res) => {  const chunks: Buffer[] = [];  req.on('data', (chunk) => chunks.push(chunk));  req.on('end', async () => {    const raw = Buffer.concat(chunks).toString('utf8');    if (!isFromSignage(raw, String(req.headers['x-signature'] ?? ''))) {      res.writeHead(401).end();      return;    }    res.writeHead(204).end(); // Binnen 10 Sekunden antworten, danach arbeiten     const deliveryId = String(req.headers['x-delivery-id']);    if (seen.has(deliveryId)) return;    seen.add(deliveryId);     const event = req.headers['x-event-type'];    const payload = JSON.parse(raw);    const moved = event === 'fleet.player.updated' && payload.changedFields?.includes('locationId');    if (event === 'fleet.player.created' || moved) {      await assignProgramOfLocation(payload.playerId).catch((error) => console.error(error));    }  });}).listen(8080);

3. Legen Sie den Endpunkt an, im Portal unter Einstellungen › Für Entwickler › Webhooks mit Endpunkt anlegen. Tragen Sie Ihre https-Adresse ein, wählen Sie unter Abonnierte Ereignisse fleet.player.created und fleet.player.updated und klicken Sie auf Anlegen. Kopieren Sie das Secret nach WEBHOOK_SECRET und starten Sie den Empfänger.

4. Probieren Sie es aus mit einem neuen Web-Display, siehe Ein Display anlegen und bespielen, aber ohne Programm zuzuweisen. Wenige Sekunden später nennt GET /v1/players/{id}/program das Programm seines Standorts.

Dasselbe Programm zweimal zuzuweisen schadet nicht. Eine wiederholte Zustellung richtet also auch nach einem Neustart des Empfängers keinen Schaden an.

Ergebnis prüfen#

• Der Empfänger schreibt je neuem Display eine Zeile mit Namen und Programm.
• Im Portal zeigt das neue Display das Programm seines Standorts.
• Im Zustell-Log des Endpunkts zeigt jede Zustellung Zugestellt mit HTTP 204.

Wenn etwas nicht klappt#

Weiterführendes#

• Ein Display anlegen und bespielen
• Bei Offline eine Nachricht in Teams oder Slack
• Ereignistypen: Inhalte, Programme, Geräte, Apps