প্লেব্যাক সেশন তৈরি করুন
পরিচয় যাচাই, বিশ্বস্ত Content IDs এবং সীমিত অনুমোদনসহ DRM-X Universal Playback Session Contract-এর জন্য অনুরোধ পাঠান ও সেটি ব্যবহার করুন।
প্লেব্যাকের অনুমতি দেওয়ার প্রক্রিয়া
আপনার ব্যাকএন্ড নির্ধারণ করে কে দেখতে পারবেন। DRM-X প্লেব্যাকের অনুমোদন দেয়। প্লেয়ার সেই অনুমোদন ব্যবহার করে DRM লাইসেন্স চায়।
- দর্শক
আপনার পরিষেবায় সাইন ইন করে ভিডিও দেখার অনুরোধ করেন।
- আপনার ব্যাকএন্ড
ব্যবহারকারীর ক্রয়, সাবস্ক্রিপশন বা অন্য কোনো দেখার অনুমতি যাচাই করে।
- DRM-X
নির্বাচিত প্লেব্যাকের নিয়ম প্রয়োগ করে এবং প্লেব্যাক কনফিগারেশন ও অনুমোদন ফেরত দেয়।
- প্লেয়ার
প্রাপ্ত অনুমোদন ব্যবহার করে প্লেব্যাকের জন্য প্রয়োজনীয় DRM লাইসেন্স চায়।
একটি সার্বজনীন প্লে-ব্যাক সেশান নির্মাণ করুন#
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-beta.4"
}
}
এক সফল ফেলিস বনাম ১ সাড়ার মধ্যে রয়েছে ক্ষমতা প্রদর্শন, প্রকাশমান চিহ্ন, একটি DRM-নির্দিষ্ট লাইসেন্স URLএক অবহিত পরিমাপ পর ্ যন ্ ত ; DRM License Token অথবা গ্রাহক প্রক্সি অনুমোদন, মুক্তি রাস্তা, সর্বোচ্চ উচ্চতা, এবং অনুমোদিত ট্র্যাকের মাধ্যমে এটি ফেরত দিন। Cache-Control: no-store.
একটি অকল্পনীয় সেশান ব্যবহার করুন ID প্রতিটি প্রকৃত প্লেব্যাক চেষ্টার জন্য। ID ডিভাইসের মধ্যে উপস্থিত তথ্যের পরিমাণ অনুমান করা হয় ।
সফল প্রতিক্রিয়ার উদাহরণ
এই উদাহরণে অকার্যকর নমুনা URL ও স্থানধারক টোকেন ব্যবহৃত হয়েছে। নেস্ট করা বর্ণনাকারীগুলো পড়ুন; পুরোনো ইন্টিগ্রেশনের জন্য সামঞ্জস্যপূর্ণ বিকল্প নাম দেওয়া আছে।
{
"contractVersion": 1,
"playbackMode": "streaming",
"sessionId": "c9006ed8-58c8-45db-9ed0-311d1047c210",
"contentId": "course-12-lesson-4",
"drmSystem": "widevine",
"manifestUrl": "https://media.example.test/course-12/manifest.mpd",
"manifestUrls": {"dash": "https://media.example.test/course-12/manifest.mpd"},
"expiresAt": "2026-10-26T12:10:00Z",
"drm": {
"system": "widevine",
"licenseServerUrl": "https://license6.drm-x.com/v1/licenses/widevine",
"drmLicenseToken": "REDACTED_EXAMPLE_ONLY",
"tokenType": "Bearer",
"fairPlayCertificateUrl": null
},
"release": {
"url": "https://license6.drm-x.com/v1/playback-sessions/release",
"method": "POST",
"authorizationScheme": "Bearer"
},
"policy": {"maximumHeight": 1080, "allowedTrackTypes": ["AUDIO", "SD", "HD"]},
"tracks": {"audioLanguageSelection": true, "subtitleLanguageSelection": true, "languageTagStandard": "BCP-47"},
"platformCapabilities": null,
"playerBranding": null,
"token": "REDACTED_EXAMPLE_ONLY",
"tokenType": "Bearer",
"licenseServerUrl": "https://license6.drm-x.com/v1/licenses/widevine",
"fairPlayCertificateUrl": null,
"releaseUrl": "https://license6.drm-x.com/v1/playback-sessions/release",
"maximumHeight": 1080,
"allowedTrackTypes": ["AUDIO", "SD", "HD"]
}
প্রমাণীকরণ আবশ্যক#
এটি কল API একটি প্রকল্প থেকে আপনার ব্যাক-এন্ড API ক্লায়েন্টের জন্য অনুরোধ করা হয়েছে license-tokens:createপরিবেশ ব্যবহার করো UUID যেমন siteIdআপনার পরিচয় প্রমাণকারী প্রদর্শক আপনার শেষ প্রান্তে পৌঁছে দিতে পারেন; নীচে আপনার বিশ্বস্ত ক্ষেত্রের সমাপ্তি উল্লেখ করুন।
| যে কোনো ক্ষেত্র | মানে | বিভাজনের নিয়ম |
|---|---|---|
contentId | প্রকাশকৃত বিষয়বস্তুর প্রসঙ্গ | বিন্যাস পরীক্ষা করার পর আপনার বিশ্বস্ত ক্যাটালগ থেকে সমাধান করুন । |
subject | আপনার স্থায়ী প্রদর্শক সনাক্তকরণ | অনুমোদিত সেশান থেকে D-visive, ক্লায়েন্ট ব্যবহারকারী উপস্থিত নেই ID. |
drmSystem | widevine, playready, fairplayঅথবা: wiseplay | নির্বাচিত অংশ মেলানো হবে DRM চিহ্নিত স্থানে প্লেয়ার ক্ষমতা। |
sessionId | এই প্লে-ব্যাকের পরিচয় পংক্তি | প্রতিটি প্রচেষ্টার জন্য একটি নতুন অপ্রত্যাশিত মান নির্মাণ করুন । |
contentType | vod অথবা live | বিষয়বস্তুর জন্য চিহ্নিত ধরন ব্যবহার করুন । |
playbackMode | streaming কোসমূহstar name | প্লে-ব্যাকের সাথে পরে চুক্তির জন্য একটি এক্সটেনশন আবশ্যক। |
licensePolicyTemplate / licensePolicy | একটি নাম পলিসি অথবা স্বনির্ধারিত নীতি | আপনার সার্ভার- এ নির্বাচন করো; দু' টি সরবরাহ করো না । নিয়ম সংক্রান্ত নিয়মাবলী. |
platformCapabilities | প্ল্যাটফর্ম, DRM সিস্টেম, প্রদর্শন ও ডিভাইস ইঙ্গিত প্রদর্শন করা হবে | নতুন শুদ্ধতা সম্পর্কিত স্পষ্ট ক্ষমতা পাঠাও । তারা ক্লায়েন্টকে বর্ণনা করে; তারা লাইসেন্স পলিসির থেকে অগ্রাহ্য করে না । |
প্রতিদ্বন্ধিতা#
defted H1. sprites থেকে প্রাপ্ত লাইসেন্স URL- র ব্যবহার করা হবে না অথবা নিবন্ধিত প্রকাশকৃত URL- র পরিবর্তে নিবন্ধিত ইউ. আর- এল ব্যবহার করুন প্লেয়ার ইনপুট।
| প্রাপ্ত ক্ষেত্র | কিভাবে এটা ব্যবহার করবো |
|---|---|
contractVersion | প্রাপ্ত চুক্তিপত্রের সংস্করণ নিশ্চিত হয়েছে যে আপনার সাথে যোগাযোগ করা হয়েছে । |
manifestUrl / manifestUrls | নির্বাচিত স্পষ্ট পরিচয় অথবা স্পষ্ট সংকেত সহ "%s" লোড করুন। |
expiresAt | এই বিস্কিট অনুমোদন করা হয়েছে. |
drm | পড়ো system, licenseServerUrl, drmLicenseToken, tokenTypeআর সম ্ মানিত , গুণান ্ নিত । fairPlayCertificateUrlএকটি গ্রাহকের টোকেন প্রক্সি নিজস্ব সেশন-এর সঙ্গে যুক্ত অনুমোদন করে তৈরি ব্রাউজারের পরিবর্তে প্রতিস্থাপন করতে পারে । |
release | ব্যবহার করা হবে url, methodএবং authorizationScheme প্লে-ব্যাক সমাপ্তির পরে সেশানের কর্ম মুক্ত করা হবে। |
policy | সম্মান maximumHeight এবং allowedTrackTypesproviders এখনও স্বাক্ষরিত পলিসি প্রয়োগ করে. |
tracks | অডিও/অভিধানক ভাষার উপ-নির্বাচন ক্ষমতা এবং ভাষার-ট্যাগের প্রমিততা পড়ুন। |
তুমি ফিরে যাও প্লেয়ার প্রত্যুত্তর Cache-Control: no-storeএই প্রজেক্ট কখনো চলবে না Access Key অনুমোদন ব্যবস্থা উপলব্ধ করা হয়। লাইসেন্স এবং সার্টিফিকেট প্রাপ্ত করার জন্য চিহ্নিত কমান্ড প্রয়োগ করা হবে।
সংশোধন এবং সংস্করণ সংরক্ষণ করা হয়েছে#
HTTPের অবস্থা আর মেশিন- পরিষ্কার করো code। সমস্যা সমাধানের এবং সম্মান প্রদর্শনের জন্য requestIdকে পুনরায় বিয়ে করা এবং সম্মান করা উচিত; retryableকে অস্বীকার করা অথবা অবৈধ নীতি গ্রহণ করা সঠিক সিদ্ধান্তের প্রয়োজন, পুনরায় লুপ না করে পুনরায় সিদ্ধান্ত নিতে হবে। ব্যাক সেশন এ সমস্যা বোধ করো error code Alb.
বন্ধ করুন, প্লে-ব্যাক প্রতিস্থাপন, টার্মিন্যাল ত্রুটি ও অ্যাপ্লিকেশন বন্ধ করার প্রচেষ্টা করা হচ্ছে। নতুন সেশান আরম্ভের প্রচেষ্টা ব্যর্থ হলে এই সমস্যা দেখা দিতে পারে। ID.
POST https://license6.drm-x.com/v1/playback-sessions/release
Authorization: Bearer REDACTED_EXAMPLE_ONLY
Accept: application/json
HTTP/1.1 200 OK
{"contractVersion":1,"released":true,"code":"license_session_released","requestId":"example-request-id"}
ফেরত পাওয়া রিলিজ URL ও অনুমোদন পদ্ধতি একই DRM License Token-এর সঙ্গে ব্যবহার করুন। অনুরোধের বডি দরকার নেই। অনুমোদিত পুনরাবৃত্ত রিলিজ অনুরোধ HTTP 200, released false এবং code license_session_not_active ফেরত দেয়। মেয়াদোত্তীর্ণ বা অবৈধ অনুমোদন রিলিজের আগেই ব্যর্থ হতে পারে; নতুন প্লেব্যাক চেষ্টার জন্য নতুন অনুমোদন নিন। সাময়িক পরিষেবা ত্রুটিতে অপেক্ষার সময় বাড়িয়ে সীমিত সংখ্যকবার চেষ্টা করুন।
এই প্রকাশ্য চুক্তি স্ট্রিমিং বর্ণনা করে। গ্রাহকের নিজস্ব অফলাইন এন্ডপয়েন্ট ও ডিভাইসের সঙ্গে যুক্ত স্থায়ী লাইসেন্সের আলাদা কর্মপ্রবাহ আছে; এই স্ট্রিমিং প্রতিক্রিয়াকে অফলাইন লাইসেন্স হিসেবে আবার ব্যবহার করবেন না।
DRM-X 6.0