Αυτοματισμός μέσω API

Το CUE Manager παρέχει API και Socket.IO events για τον απομακρυσμένο έλεγχο και ενσωμάτωση με εξωτερικά συστήματα.

REST API Endpoints

Λήψη Δεδομένων

GET /api/get?authKey=[key]&type=rundowns

Επιστρέφει τη λίστα των rundowns.

GET /api/get?authKey=[key]&type=rundown&id=[rundown_id]

Επιστρέφει τα δεδομένα συγκεκριμένου rundown.

Λήψη Link Devices

GET /api/get?authKey=[key]&type=linkdevices

Επιστρέφει τη λίστα των συνδεδεμένων Link devices.

Κατάσταση Server

GET /api/status

Επιστρέφει πληροφορίες έκδοσης και κατάστασης.

AI Endpoints

GET /api/ai/text?authKey=[key]&prompt=[text]&action=[action]

Ενέργειες AI για κείμενο.

POST /api/ai/image

Δημιουργία εικόνας με AI.

POST /api/ai/imageedit

Επεξεργασία εικόνας με AI.

Socket.IO Events

Σύνδεση

const socket = io('https://cue.gfxmanager.com');

socket.emit('auth', {
  username: 'your-username',
  password: 'your-password'
});

socket.on('authresponse', (response) => {
  if (response.status === 200) {
    console.log('Connected!');
  }
});

Εκπομπή Events (Client → Server)

Event	Payload	Περιγραφή
createRundown	{name, type, date}	Δημιουργία rundown
deleteRundown	{id}	Διαγραφή rundown
change	{rundownId, changes}	Αλλαγή σε rundown
chatPostMessage	{rundownId, message}	Μήνυμα chat
linkcommand	{deviceId, command}	Εντολή σε Link device
saveUserPref	{key, value}	Αποθήκευση προτίμησης

Λήψη Events (Server → Client)

Event	Περιγραφή
change	Ενημέρωση για αλλαγή rundown
playProgress	Πρόοδος αναπαραγωγής
chatPostMessage	Λήψη μηνύματος chat
scriptCommand	Ενημέρωση prompter

Ενσωμάτωση με GFX Manager CG

Το CUE Manager συνδέεται αυτόματα με τις υπηρεσίες GFX Manager CG που έχετε ορίσει στις ρυθμίσεις.

Προσθήκη Υπηρεσίας

1. Μεταβείτε στις Ρυθμίσεις

2. Στην ενότητα "Υπηρεσίες", πατήστε Προσθήκη

3. Εισάγετε το URL της υπηρεσίας CG

4. Εισάγετε το API key

5. Πατήστε Αποθήκευση

Διαθέσιμες Εντολές

Μετά τη σύνδεση, οι εντολές CG εμφανίζονται στο μενού:

• Templates

• Εντολές ανά template

• Όλα τα controls

Ενσωμάτωση με Link Manager

Τα Link devices που είναι συνδεδεμένα εμφανίζονται αυτόματα στο CUE Manager.

Αποστολή Εντολής

socket.emit('linkcommand', {
  deviceId: 'device-uuid',
  command: {
    capability: 'cut',
    parameters: {
      input: 1
    }
  }
});

Παράδειγμα: Python Script

import socketio

sio = socketio.Client()

@sio.event
def connect():
    print('Connected')
    sio.emit('auth', {
        'username': 'your-username',
        'password': 'your-password'
    })

@sio.on('authresponse')
def on_auth(data):
    if data['status'] == 200:
        print('Authenticated!')
        # Τώρα μπορείτε να στείλετε εντολές

@sio.on('change')
def on_change(data):
    print(f'Rundown changed: {data}')

sio.connect('https://cue.gfxmanager.com')
sio.wait()

Παράδειγμα: Node.js

const io = require('socket.io-client');
const socket = io('https://cue.gfxmanager.com');

socket.on('connect', () => {
  socket.emit('auth', {
    username: 'your-username',
    password: 'your-password'
  });
});

socket.on('authresponse', (response) => {
  if (response.status === 200) {
    console.log('Authenticated!');
    
    // Αλλαγή σε rundown
    socket.emit('change', {
      rundownId: 'rundown-id',
      changes: {
        // ...
      }
    });
  }
});

Κωδικοί Σφάλματος

Κωδικός	Περιγραφή
200	Επιτυχία
401	Μη έγκυρα στοιχεία
402	Η άδεια έχει λήξει
403	Δεν υπάρχει δικαίωμα
404	Δεν βρέθηκε
500	Σφάλμα server

Ασφάλεια

Θέμα	Σύσταση
Κωδικοί	Μην τους αποθηκεύετε σε κώδικα
HTTPS	Χρησιμοποιήστε πάντα HTTPS
Δικαιώματα	Δημιουργήστε χρήστες με περιορισμένα δικαιώματα για API