Tạo phiên phát

Request and consume the DRM-X Universal Playback Session Contract with authentication, trusted Content IDs, and bounded authorization.

Xem Markdown Ví dụ chạy trực tiếpCập nhật 2026-09-05

Hậu phương của bạn quyết định truy cập; DRM-X Áp dụng chính sách đã ký. DRM Bằng lái đi theo đường giao hàng riêng.

API

Tạo một phiên chạy phát lại chung#

POST https://api6.drm-x.com/api/v1/playback/environments/{siteId}/sessions
Accept: application/json
Content-Type: application/json
X-DRMX-Client-Id: {siteKey}
X-DRMX-Client-Secret: {accessKey}

{
  "contentId": "course-12-lesson-4",
  "contentType": "vod",
  "drmSystem": "widevine",
  "subject": "customer-user-1001",
  "sessionId": "new-unpredictable-id-per-playback",
  "playbackMode": "streaming",
  "licensePolicyTemplate": "multi-tier-standard",
  "useEnvironmentDefaults": true,
  "applicationId": "customer-web",
  "platformCapabilities": {
    "clientPlatform": "web",
    "drmSystems": ["widevine"],
    "manifestTypes": ["dash"],
    "maximumHeight": 2160,
    "persistentState": false,
    "sdkVersion": "1.2.0-preview.6"
  }
}

Một câu trả lời hợp đồng thành công bao gồm các bản tuyên bố có thẩm quyền, có sẵn các biến thể, một DRM-giấy phép đặc biệt URLMột cuộc sống ngắn ngủi DRM License Token hoặc quyền ủy nhiệm khách hàng, lộ trình phóng thích, cấp phép cao nhất, và cho phép đường ray. Cache-Control: no-store.

Dùng một phiên chạy không thể đoán trước ID cho mỗi lần thử phát lại. ID thông qua các thiết bị đánh bại đếm ngược cùng thời điểm.

Xác thực và các trường yêu cầu tin cậy#

Gọi cái này đi API từ hậu phương của bạn với một dự án API Khách hàng có license-tokens:createDùng môi trường UUID dạng siteIdNgười xem xác thực của bạn gọi điểm kết thúc của bạn; điểm kết thúc của bạn cung cấp các trường tin cậy bên dưới.

Tìm kiếm	Nghĩa là	Quy tắc hợp nhất
`contentId`	Tài liệu tham khảo nội dung được xuất bản	Giải quyết từ danh mục tin cậy sau khi kiểm tra phúc lợi xã hội.
`subject`	Bộ nhận diện trình xem ổn định của bạn	Derive từ phiên chạy xác thực, không phải là người dùng ứng dụng khách ID.
`drmSystem`	`widevine`, `playready`, `fairplay`, hoặc `wiseplay`	Khớp điều đã chọn DRM đến trình phát Khả năng.
`sessionId`	Danh tính của nỗ lực phát lại này	Tạo ra một giá trị không thể đoán trước cho mỗi nỗ lực.
`contentType`	`vod` hay `live`	Dùng kiểu đã đăng ký cho nội dung.
`playbackMode`	`streaming` trong hợp đồng	Phần phát lại ngoại tuyến đòi hỏi phần mở rộng hợp đồng sau.
`licensePolicyTemplate` / `licensePolicy`	Name	Hãy chọn trên máy phục vụ của bạn; đừng cung cấp cả hai. Xem quy tắc chính sách.
`platformCapabilities`	Nền tảng, DRM hệ thống, kiểu trình bày và gợi ý thiết bị	Gửi khả năng rõ ràng với sự tích hợp mới. Chúng mô tả ứng dụng khách, không ghi đè lên chính sách chứng nhận.

Tiêu thụ các ghi chú đáp ứng#

Dùng hợp đồng lồng nhau v1 descripters. Đừng xây dựng các đường dẫn chứng nhận từ các dự đoán hoặc thay thế các URL đã đăng ký trình phát Đầu vào.

Trường đáp ứng	Cách sử dụng nó
`contractVersion`	Kiểm tra xem phiên bản hợp đồng trả lại được hỗ trợ bởi sự tích hợp của bạn.
`manifestUrl` / `manifestUrls`	Tải danh sách đã chọn hoặc một biến thể tương thích với trả lại.
`expiresAt`	Sự giải thoát của giấy phép bị hạn chế này.
`drm`	Đọc `system`, `licenseServerUrl`, `drmLicenseToken`, `tokenType`và tùy chọn `fairPlayCertificateUrl`. một ủy nhiệm hiệu suất khách hàng có thể thay thế quyền truy cập tới trình duyệt bằng phiên chạy bị hạn chế riêng.
`release`	Sử dụng nó `url`, `method`, và `authorizationScheme` để phát hành phiên chạy khi phát lại kết thúc.
`policy`	Danh dự `maximumHeight` và `allowedTrackTypes`Nhà cung cấp vẫn thực thi chính sách đã được ký.
`tracks`	Đọc khả năng chọn ngôn ngữ/phụ và tiêu chuẩn thẻ ngôn ngữ.

Trả lại của bạn trình phát trả lời với Cache-Control: no-storeKhông bao giờ chuyển tiếp dự án Access Key cho trình duyệt. Giới hạn quyền sở hữu đầu trang tới các đường dẫn chứng nhận và giấy phép trả về.

Xử lý lỗi và gỡ bỏ vùng đặt trước#

Kiểm tra HTTP Trạng thái và Máy đọc được codeGiữ lại requestId Đối với rắc rối bắn súng và tôn trọng retryable; một chính sách bị từ chối hoặc không hợp lệ cần một quyết định đúng, không phải một vòng lặp thử lại. Xem Gặp lỗi khi phát lại phiên chạy.

Phát hành đặt chỗ trên trạm dừng, phát lại thay thế, lỗi thiết bị cuối, và tắt ứng dụng. Một nỗ lực phát lại mới có một phiên chạy mới ID.