主要な概念 key-concepts

実装を成功させるためには、同時実行性モニタリングの中心概念を理解することが不可欠です。 このガイドでは、基本的な構成要素と、それらが連携する仕組みについて説明します。

中心概念 core-concepts

セッション

セッション は、アクティブなビデオストリーミングインスタンスを表します。 ユーザーがコンテンツを視聴できる「チケット」と考えてください。

セッションライフサイクル

セッションのプロパティ

{
  "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"
  }
}

ポリシー

ポリシー は、同時ストリーミングの制限を定義するビジネスルールです。 ユーザーが新しいストリームを開始できるタイミングを決定します。

ポリシーコンポーネント

サンプルポリシー

{
  "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"
    }
  ]
}

メタデータ

メタデータ は、各セッションに関するコンテキストを提供します。 デバイス、コンテンツ、ユーザー、アプリケーションに関する情報も含まれます。

メタデータカテゴリ

必須メタデータとオプションメタデータ

ID と認証 identity-and-authentication

ID プロバイダー（IdP）

ID プロバイダー は、ユーザーを認証し、ユーザーの ID 情報を提供するサービスです。 Adobe Pass統合では、通常、これはMVPDです。

IdP の例

件名

件名 は、ID プロバイダー内のユーザーの一意の ID です。 これは、通常、ユーザーのアカウント ID または購読者 ID です。

セッション管理 session-management

ハートビート

ハートビート は、セッションをアクティブに保つ定期的な API 呼び出しです。 彼らはシステムに「このユーザーはまだ見ています」と言います。

ハートビートの要件

セッション終了

セッションは、いくつかの方法で終了できます。

ポリシーの評価 policy-evaluation

ポリシーの仕組み

競合の解決 conflict-resolution

競合とは

競合 は、ユーザーが新しいストリームを開始しようとして、制限を超えた場合に発生します。

競合応答

競合が発生すると、システムは 409 Conflict 応答と詳細な情報を返します。

{
  "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": {...}
            }
          ]
        }
      }
    ]
  }
}

解決戦略

LIFO （ラストイン、ファーストアウト）

FIFO （先入れ先出し）

アプリケーションとテナント applications-and-tenants

用途

アプリケーション は、同時実行性監視と統合されるソフトウェアプログラムです。 各アプリケーションには一意の ID があり、独自のポリシーを持つことができます。

アプリケーション例

テナント

テナント は、1 つ以上のアプリケーションを所有する組織です。 テナントは、アプリケーション間でポリシーを共有できます。

テナントの構造

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

環境 environments

ステージング環境

実稼動環境

統合フロー integration-flow

基本フロー

エラー処理

一般的な用語 common-terminology