Concepts clés key-concepts

La compréhension des concepts de base de la surveillance de concurrence est essentielle pour une implémentation réussie. Ce guide explique les blocs de création fondamentaux et la manière dont ils fonctionnent ensemble.

Concepts de base core-concepts

Sessions

Une session représente une instance de diffusion vidéo en continu active. Considérez-le comme un « ticket » qui permet à un utilisateur ou une utilisatrice de regarder du contenu.

Cycle de vie de la session

Propriétés de la session

{
  "sessionId": "unique-session-identifier",
  "idp": "identity-provider",
  "subject": "user-identifier",
  "startTime": "2024-01-15T10:30:00Z",
  "expiresAt": "2024-01-15T10:40:00Z",
  "metadata": {
    "deviceId": "device-123",
    "channel": "Channel1",
    "contentType": "live"
  }
}

Politiques

Politiques sont des règles d’entreprise qui définissent des limites et des restrictions pour la diffusion en continu simultanée. Ils déterminent à quel moment les utilisateurs peuvent démarrer de nouveaux flux.

Composants de politique

Exemple de politique

{
  "name": "basic_stream_limit",
  "description": "Maximum 3 concurrent streams per user",
  "rules": [
    {
      "type": "maxstreams",
      "limit": 3,
      "message": "You have reached your maximum of 3 concurrent streams"
    }
  ]
}

Métadonnées

Métadonnées fournit un contexte pour chaque session. Il contient des informations sur l’appareil, le contenu, l’utilisateur et l’application.

Catégories de métadonnées

Métadonnées obligatoires ou facultatives

Identité et authentification identity-and-authentication

Fournisseur d’identité (IdP)

Un fournisseur d’identité est le service qui authentifie les utilisateurs et fournit leurs informations d’identité. Dans l’intégration d’Adobe Pass, il s’agit généralement d’un MVPD.

Exemples d’IdP

Objet

Un objet est l’identifiant unique d’un utilisateur dans un fournisseur d’identité. Il s’agit généralement de l’identifiant de compte ou d’abonné de l’utilisateur.

Gestion de session session-management

Heartbeats

Heartbeats sont des appels API périodiques qui maintiennent les sessions actives. Ils indiquent au système que « cet utilisateur continue à regarder ».

Exigences de pulsation

Fin de session

Les sessions peuvent être interrompues de plusieurs manières :

Évaluation Des Politiques policy-evaluation

Fonctionnement des politiques

Résolution de conflits conflict-resolution

Qu’est-ce qu’un conflit ?

Un conflit se produit lorsqu’un utilisateur ou une utilisatrice tente de démarrer un nouveau flux, mais dépasse ses limites.

Réponse aux conflits

Lorsqu’un conflit se produit, le système renvoie une réponse 409 Conflit avec des informations détaillées :

{
  "status": "error",
  "error": {
    "code": "POLICY_VIOLATION",
    "message": "Concurrent usage limit exceeded"
  },
  "evaluationResult": {
    "decision": "DENY",
    "associatedAdvice": [
      {
        "adviceType": "rule-violation",
        "attributes": {
          "rule": "max_streams",
          "threshold": 3,
          "current": 4,
          "conflicts": [
            {
              "sessionId": "session-123",
              "terminationCode": "term-456",
              "metadata": {...}
            }
          ]
        }
      }
    ]
  }
}

Stratégies de résolution

LIFO (Last In, First Out)

FIFO (First In, First Out)

Applications et clients applications-and-tenants

Application

Une application est un programme logiciel qui s'intègre à la surveillance d'accès simultané. Chaque application possède un identifiant unique et peut avoir ses propres politiques.

Exemples d’applications

Locataire

Un client est une organisation qui possède une ou plusieurs applications. Les clients peuvent partager des politiques entre les applications.

Structure du client

Tenant: "Streaming Company"
├── Application: "Mobile App"
├── Application: "Web App"
└── Application: "TV App"

Environnements environments

Environnement d’évaluation

Environnement de production

Flux d’intégration integration-flow

Flux de base

Gestion des erreurs

Terminologie courante common-terminology