শাকা প্লেয়ার মাইগ্রেশনে HLS

সংক্ষিপ্ত বিবরণ

কাস্ট ওয়েব রিসিভার SDK বিভিন্ন ওয়েব স্ট্রিমিং প্রোটোকল ব্যবহার করে কন্টেন্টের প্লেব্যাক সমর্থন করে। ব্যবহৃত প্রোটোকলের উপর ভিত্তি করে, SDK কন্টেন্টের প্লেব্যাক পরিচালনা করার জন্য একটি প্লেয়ার লোড করে। HLS কন্টেন্টের ক্ষেত্রে, মিডিয়া প্লেয়ার লাইব্রেরি ( MPL ) লোড করা হয়। DASH কন্টেন্টের ক্ষেত্রে, Shaka Player লোড করা হয়।

ভবিষ্যতে, কাস্ট SDK এবং শাকা প্লেয়ার ইঞ্জিনিয়ারিং টিম শাকা প্লেয়ারে HLS কন্টেন্ট প্লেব্যাকের সমর্থন বাড়ানোর জন্য প্রচেষ্টা একীভূত করছে। MPL আর গুরুত্বপূর্ণ আপডেট পাবে না । আমরা আপনাকে আপনার অ্যাপ্লিকেশনের HLS কন্টেন্ট প্লেব্যাকের জন্য শাকা প্লেয়ার ব্যবহার করার পরামর্শ দিচ্ছি।

শাকা প্লেয়ারের সুবিধা

খেলোয়াড় পরিবর্তনের ক্ষেত্রে, অ্যাপ্লিকেশনগুলি নিম্নলিখিত সুবিধাগুলি উপভোগ করে:

• ব্যবহারকারীদের জন্য আরও শক্তিশালী স্ট্রিমিং সেশন , লোড টাইম ব্যর্থতা এবং লেটেন্সির উন্নতি সহ।
• সর্বশেষ HLS বৈশিষ্ট্যগুলির ক্রমাগত গ্রহণ।
• শাকা প্লেয়ারের ওপেন সোর্স প্রকৃতির কারণে প্লেয়ার-কন্টেন্ট সামঞ্জস্যের সমস্যাগুলির মূল কারণ বিশ্লেষণে বর্ধিত স্পষ্টতা ।
• ওপেন সোর্স প্লেয়ার কোডবেস অংশীদারদের শাকা প্লেয়ার প্রজেক্টে অবদান রাখার সুযোগ করে দেয়।
• শাকা প্লেয়ারের রিলিজ ক্যাডেন্স ঘন ঘন এবং ওয়েব রিসিভার SDK এর রিলিজ থেকে স্বাধীন হওয়ায় ফিচার এবং বাগ ফিক্সের সময় উল্লেখযোগ্যভাবে হ্রাস পেয়েছে ।
• shakaVersion API দ্বারা প্রদত্ত প্লেব্যাক পরিবেশের উপর বৃহত্তর নিয়ন্ত্রণ ।
• রোডম্যাপে যেমন দেখা গেছে, শাকা প্লেয়ারে HLS প্লেব্যাকের উপর দৃষ্টি নিবদ্ধ করে ইঞ্জিনিয়ারিং রিসোর্স সহ গুগলের প্লেব্যাক সমর্থন বৃদ্ধি করা হয়েছে ।

সময়রেখা

ওয়েব রিসিভার SDK HLS কন্টেন্ট প্লেব্যাকের জন্য ডিফল্ট প্লেয়ার হিসেবে Shaka Player ব্যবহারে রূপান্তরিত হবে। মাইগ্রেশন প্রক্রিয়ার মাধ্যমে অংশীদারদের গাইড করার জন্য এটি পর্যায়ক্রমে করা হবে।

পর্যায়	শুরুর তারিখ	সংক্ষিপ্ত বিবরণ
১	অক্টোবর '২২	কাস্ট ওয়েব রিসিভার SDK শাকা প্লেয়ারে HLS কন্টেন্ট চালানোর জন্য API গুলি চালু করে ।
২	Q1 '26	কাস্ট ওয়েব রিসিভার SDK HLS কন্টেন্ট প্লেব্যাকের জন্য ডিফল্ট প্লেয়ারকে Shaka Player এ পরিবর্তন করে ।

ওয়েব রিসিভার SDK ইঞ্জিনিয়ারিং টিমগুলি পারফরম্যান্স-ভিত্তিক পদ্ধতি গ্রহণ করছে এবং শাকা প্লেয়ারের পারফরম্যান্স MPL-এর বেসলাইন পারফরম্যান্সের সমান হলেই কেবল পরবর্তী পর্যায়ে যাবে। এই পরিবর্তনগুলি cast-sdk-announcements গুগল গ্রুপে ঘোষণা করা হবে এবং এই নির্দেশিকায় আপডেট করা হবে।

বেছে নিন

CAF সংস্করণ 3.0.0105 দিয়ে শুরু করে, HLS প্লেব্যাকের জন্য Shaka Player ব্যবহার করার জন্য একটি অ্যাপ্লিকেশন স্তরের কনফিগারেশন রয়েছে। এই সংস্করণটি লোড করার জন্য Shaka Player সংস্করণের সমর্থিত পরিসর থেকে নির্বাচন করার জন্য একটি APIও প্রবর্তন করে। এই ফ্ল্যাগগুলি useShakaForHls এবং shakaVersion বৈশিষ্ট্যের মাধ্যমে CastReceiverOptions ক্লাসে সরবরাহ করা হয় এবং CastReceiverContext শুরু হলে মূল্যায়ন করা হয়। HLS এর জন্য Shaka-তে অপ্ট ইন করা যেকোনো অ্যাপ্লিকেশনের সর্বশেষ HLS উন্নতির সুবিধা নিতে কমপক্ষে 4.15.12 এর Shaka Player সংস্করণ সেট করা উচিত। অপ্ট-ইন করতে, নীচের কোড স্নিপেটটি অনুসরণ করুন:

const context = cast.framework.CastReceiverContext.getInstance();

let castReceiverOptions = new cast.framework.CastReceiverOptions();
castReceiverOptions.useShakaForHls = true;

context.start(castReceiverOptions);

দ্রষ্টব্য: সেট করা হলে, shakaVersion প্রপার্টিটি Shaka Player ভার্সনটিকে পিন করে। এটি ওয়েব রিসিভার SDK দ্বারা নির্ধারিত ডিফল্ট মানকে ওভাররাইড করে। ডিফল্ট Shaka Player ভার্সনটি আপনার সেট করা ভার্সনের চেয়ে বড় হলে আমরা shakaVersion প্রপার্টিটি সরিয়ে ফেলার পরামর্শ দিচ্ছি। এইভাবে আপনার অ্যাপ্লিকেশনটি সর্বশেষ ওয়েব রিসিভার SDK পরিবর্তনের সাথে আপ টু ডেট থাকে। ডিফল্ট Shaka Player ভার্সনে পরিবর্তনগুলি রিলিজ নোটে পোস্ট করা হয় এবং cast-sdk-announcements google গ্রুপের মাধ্যমে জানানো হয়।

কন্টেন্ট যাচাই করুন

অংশীদারদের তাদের প্রোডাকশন অ্যাপে Shaka Player ব্যবহার করার আগে Shaka Player-এ তাদের কন্টেন্ট প্লেব্যাক যাচাই করা উচিত। আমরা নীচে তালিকাভুক্ত আপনার কন্টেন্টের প্রতিটি বৈচিত্র্য পরীক্ষা করার পরামর্শ দিচ্ছি:

• স্ট্রিম প্রকার: লাইভ অথবা ভিওডি
• কন্টেইনার ফর্ম্যাট: টিএস, এমপি৪, অথবা প্রাথমিক স্ট্রিম
• বিচ্ছিন্নতা বা এম্বেড করা বিজ্ঞাপন সহ কন্টেন্ট
• নিম্নলিখিত ধরণের ডিভাইসে প্লেব্যাক: স্মার্ট ডিসপ্লে, গুগল কাস্ট ডঙ্গল, অ্যান্ড্রয়েড টিভি ডিভাইস, গুগল কাস্ট সহ টিভি, স্মার্ট স্পিকার

যদি আপনি কোন ত্রুটি বা অপ্রত্যাশিত আচরণ খুঁজে পান, তাহলে একটি বাগ ফাইল করুন । একবার আপনি যাচাই করতে সক্ষম হন যে আপনার কন্টেন্টে কোন গুরুত্বপূর্ণ প্লেব্যাক ব্যর্থতা নেই, তাহলে আপনার প্রোডাকশন পরিবেশে পরিবর্তনগুলি পুশ করুন।

অপ্ট আউট করুন

ওয়েব রিসিভার SDK টাইমলাইন অনুসারে Shaka Player HLS কন্টেন্ট প্লেব্যাকের জন্য একটি অপ্ট-আউট মডেলে রূপান্তরিত হবে। useShakaForHls প্রোপার্টিটি তার ডিফল্ট মান false থেকে true এ পরিবর্তন করবে। সেই সময়ে, অ্যাপ্লিকেশনগুলি এই প্রোপার্টিটি ম্যানুয়ালি false এ সেট করে HLS প্লেব্যাকের জন্য MPL ব্যবহার করতে বেছে নিতে পারে। CastReceiverContext শুরু হলে, ওয়েব রিসিভার SDK Shaka Player এর পরিবর্তে MPL লোডিংয়ে ফিরে যাবে। অপ্ট-আউট করার পদ্ধতি জানতে নীচের নমুনাটি দেখুন:

const context = cast.framework.CastReceiverContext.getInstance();

let castReceiverOptions = new cast.framework.CastReceiverOptions();
castReceiverOptions.useShakaForHls = false;

context.start(castReceiverOptions);

সমস্যাগুলি রিপোর্ট করুন

আমরা আমাদের অংশীদারদের HLS কন্টেন্ট চালানোর সময় যে কোনও সমস্যা দেখা দিলে তা জানাতে উৎসাহিত করি। যেমনটি উল্লেখ করা হয়েছে, MPL আর গুরুত্বপূর্ণ আপডেট পাবে না। MPL-এর সাথে যদি কোনও সমস্যার সম্মুখীন হয়, তাহলে Shaka Player-এ স্যুইচ করলে আপনার সমস্যাটি আনব্লক হবে কিনা তা যাচাই করার জন্য গাইডের "অপ্ট ইন" বিভাগে দেওয়া ধাপগুলি অনুসরণ করুন। যদি সমস্যাটি এখনও বিদ্যমান থাকে অথবা প্লেয়ার পরিবর্তন করার সময় আপনি যদি অন্য কোনও সমস্যার সম্মুখীন হন তবে নীচের ধাপগুলি অনুসরণ করুন।

1. সমস্যা সমাধানের জন্য shakaVersion অন্য কোন ব্রাঞ্চ ভার্সনে সেট করার চেষ্টা করুন। উদাহরণস্বরূপ, যদি 4.15 ব্রাঞ্চে সমস্যাটি দেখা দেয়, তাহলে এটিকে অন্য ব্রাঞ্চের সর্বশেষ রিলিজে সেট করার চেষ্টা করুন। সবচেয়ে প্রাসঙ্গিক আপডেট সহ রিলিজগুলি খুঁজে পেতে Shaka Player রিলিজ নোটগুলি দেখুন। মনে রাখবেন যে shakaVersion API-এর রেফারেন্স ডকুমেন্টেশনে বর্ণিত ন্যূনতম এবং সর্বাধিক সমর্থিত সংস্করণ রয়েছে। যদি আপনি লক্ষ্য করেন যে কোনও রিগ্রেশন আছে, তাহলে Shaka Player issuetracker- এ সমস্যাটি রিপোর্ট করুন।
2. প্লেয়ার কনফিগারেশন প্যারামিটার পরিবর্তন করার চেষ্টা করুন। Shaka Player PlayerConfiguration অবজেক্টের মাধ্যমে কনফিগার করা যায়। ওয়েব রিসিভার SDK ডিফল্ট মানগুলির একটি সেট সংজ্ঞায়িত করে এবং অ্যাপ্লিকেশনগুলিকে PlaybackConfig অবজেক্টের shakaConfig বৈশিষ্ট্যের মাধ্যমে এই কনফিগারেশনটি পরিবর্তন করতে সক্ষম করে। প্লেয়ার ইনস্ট্যান্স তৈরি করার সময় লোডের সময় এটি মূল্যায়ন করা হয়। অ্যাপ্লিকেশন কনফিগারেশন এবং বিকল্পগুলিতে আরও দেখুন। ওয়েব রিসিভার SDK দ্বারা সেট করা ডিফল্ট মানগুলি হল প্রস্তাবিত মান।
3. সমস্যাটি Shaka Player issuetracker অথবা Cast issuetracker- এ রিপোর্ট করা হয়েছে কিনা দেখুন। বাগ সম্পর্কে মন্তব্য করুন এবং যদি আপনার সমস্যাটি বর্ণনা করে তবে প্রাসঙ্গিক তথ্য যোগ করুন।
4. Shaka Player ডেমো সাইটে আপনার কন্টেন্ট পরীক্ষা করুন। যদি আপনি দেখেন যে সমস্যাটি আপনার কন্টেন্টের ডেমো সাইটে পুনরুত্পাদন করছে, তাহলে Shaka Player প্রজেক্টে একটি বাগ ফাইল করুন ।
5. কাস্ট এন্ডপয়েন্টে যদি শাকা প্লেয়ারের জন্য অনন্য কোনও সমস্যা থাকে, তাহলে কাস্ট ইস্যু ট্র্যাকারে একটি বাগ ফাইল করুন ।

প্রায়শই জিজ্ঞাসিত প্রশ্নাবলী

খেলোয়াড় পরিবর্তন অনেক প্রশ্নের জন্ম দিতে পারে। মাইগ্রেশন প্রক্রিয়ার মধ্য দিয়ে আপনাকে সাহায্য করার জন্য নীচে আপনি সবচেয়ে সাধারণ প্রশ্নের উত্তর পাবেন।

আমার কি শাকা প্লেয়ারে মাইগ্রেট করা উচিত?

আমরা আমাদের অংশীদারদের HLS কন্টেন্ট ব্যবহারকারীদের যত তাড়াতাড়ি সম্ভব মাইগ্রেশন প্রক্রিয়া শুরু করার জন্য উৎসাহিত করি। ফলস্বরূপ, আপনার অ্যাপটি আপনার ব্যবহারকারীদের জন্য আরও শক্তিশালী স্ট্রিমিং অভিজ্ঞতা প্রদান করবে। এই নির্দেশিকার Shaka Player সুবিধা বিভাগে আরও সুবিধাগুলি বর্ণনা করা হয়েছে। অংশীদারদের যাচাই করা উচিত যে তাদের অ্যাপগুলি Shaka Player ব্যবহার করে সঠিকভাবে কাজ করছে যাতে একটি মসৃণ রূপান্তর নিশ্চিত করা যায়। ওয়েব রিসিভার SDK যখন অপ্ট-আউট মডেলে রূপান্তরিত হয় তখন কিছু অ্যাপ ঝুঁকির মধ্যে পড়তে পারে যদি অংশীদাররা আগে থেকে যাচাই না করে যে তাদের সামগ্রী Shaka Player-এ সঠিকভাবে চলছে।

খেলোয়াড় পরিবর্তনের সময় প্রত্যাশিত প্রচেষ্টার স্তর কী?

HLS-এর তুলনায় ব্যবহারকারীর অভিজ্ঞতা একই রকম বা উন্নত কিনা তা নিশ্চিত করার জন্য অংশীদারদের তাদের অ্যাপ্লিকেশন এবং কন্টেন্ট একটি পরীক্ষামূলক পরিবেশে পরীক্ষা করতে হবে। এটি করার জন্য, অংশীদারদের একটি অভ্যন্তরীণ পরিবেশে বৈশিষ্ট্যটি নির্বাচন করতে হবে এবং তাদের কন্টেন্ট Shaka Player ব্যবহার করে চালানো সম্ভব কিনা তা পুঙ্খানুপুঙ্খভাবে পরীক্ষা করতে হবে। আপনার কন্টেন্টের কোন দিকগুলিতে ফোকাস করতে হবে তার বিশদ বিবরণের জন্য যাচাইকরণ কন্টেন্ট দেখুন। একবার যাচাই হয়ে গেলে, অংশীদারদের Shaka Player দ্বারা প্রদত্ত সুবিধাগুলি উপভোগ করা শুরু করার জন্য তাদের প্রোডাকশন অ্যাপ্লিকেশন পরিবেশে নির্বাচন করার জন্য পতাকা যুক্ত করতে হবে। উচ্চ স্তরে, আমাদের অংশীদারদের সফলভাবে স্থানান্তরিত করার জন্য ন্যূনতম সফ্টওয়্যার ডেভেলপমেন্ট পরিবর্তন এবং বেশিরভাগ QA প্রয়োজনীয়তা রয়েছে।

আমার অ্যাপ্লিকেশনটি শীঘ্রই কন্টেন্ট স্ট্রিম করার জন্য HLS ব্যবহার করবে, আমার কী করা উচিত?

নতুন ইন্টিগ্রেশনের ক্ষেত্রে শাকা প্লেয়ার প্লেব্যাকের জন্য ব্যবহার করা উচিত। দীর্ঘমেয়াদে আপনার অ্যাপ্লিকেশনটি আরও ভালভাবে সমর্থিত হবে এবং নতুন HLS বৈশিষ্ট্য এবং কর্মক্ষমতা উন্নতির সুবিধাও পাবে। যদি আপনার নতুন ইন্টিগ্রেশনে কোনও সমস্যা হয়, তাহলে যত তাড়াতাড়ি সম্ভব একটি বাগ ফাইল করুন যাতে ইঞ্জিনিয়ারিং টিম সমস্যাটি সমাধানের জন্য পর্যাপ্ত সময় পায়। যদি আপনার অ্যাপ্লিকেশনটির জন্য একটি নির্দিষ্ট সময়সীমা থাকে, তাহলে বাগ রিপোর্টে সেই তথ্য এবং সেই অনুযায়ী প্রভাবকে অগ্রাধিকার দেওয়ার জন্য অন্তর্ভুক্ত করুন। আমাদের ইঞ্জিনিয়ারিং টিম আপনার ব্যবহারকারীদের পর্যাপ্তভাবে সহায়তা করার জন্য একটি সমাধান প্রদানের জন্য কাজ করবে।

আমার কন্টেন্ট বা অ্যাপ শাকা প্লেয়ারের সাথে কাজ করে না, এখন কী হবে?

আপনার শাকা প্লেয়ার প্রজেক্ট অথবা কাস্ট প্রজেক্টের সাথে একটি বাগ ফাইল করা উচিত ( সমস্যা রিপোর্ট করুন দেখুন)। কাস্ট এসডিকে ইঞ্জিনিয়ারিং টিম সক্রিয়ভাবে এই ট্র্যাকারগুলি পর্যবেক্ষণ করছে এবং যেকোনো সমস্যা সমাধানের জন্য আপনার সাথে কাজ করবে। এই সমস্যাগুলি যত তাড়াতাড়ি সনাক্ত করা হবে, তত বেশি সময় লাগবে সমাধানের জন্য।

MPL আর গুরুত্বপূর্ণ আপডেট পাচ্ছে না, এর মানে কী?

ঐতিহাসিকভাবে, MPL নতুন HLS বৈশিষ্ট্য গ্রহণ করেছে এবং গুরুত্বপূর্ণ আপডেটের মাধ্যমে প্রধান বাগগুলি সংশোধন করেছে। এখন যেহেতু MPL আর সেগুলি গ্রহণ করবে না, তাই প্লেয়ারে নতুন HLS বৈশিষ্ট্য যোগ করা হবে না। একইভাবে, MPL-এ HLS প্লেব্যাকের জন্য রিপোর্ট করা কোনও সমস্যা MPL-এ ঠিক করা হবে না। প্লেব্যাকের জন্য Shaka Player-এ স্যুইচ করে এই সমস্যাগুলি সমাধান করা উচিত। যদি সমস্যাগুলি অব্যাহত থাকে, তাহলে Shaka Player-এ সম্মুখীন হওয়া প্রাসঙ্গিক সমস্যা(গুলি) সহ একটি বাগ ফাইল করা উচিত। অংশীদারদের MPL ব্যবহার থেকে সরে আসা উচিত।

আমার কন্টেন্ট স্মুথ স্ট্রিমিং প্রোটোকল ব্যবহার করে, এটি আমার অ্যাপ্লিকেশনকে কীভাবে প্রভাবিত করে?

MPL বাইনারিগুলি এখনও আপনার রিসিভার অ্যাপ্লিকেশনে হোস্ট করা এবং অ্যাক্সেসযোগ্য থাকবে। তবে, স্মুথ স্ট্রিমিং সম্পর্কিত কোনও বৈশিষ্ট্য অনুরোধ এবং বাগ সংশোধন সমর্থিত হবে না কারণ স্মুথ স্ট্রিমিং স্পেসিফিকেশন চার বছরেরও বেশি সময় ধরে আপডেট করা হয়নি। আপনার কন্টেন্টের জন্য পারফরম্যান্স আপডেট এবং সমর্থন পেতে DASH বা HLS স্ট্রিমিং প্রোটোকল ব্যবহার করে আপনার কন্টেন্ট স্থানান্তর করার পরামর্শ দিচ্ছি।

আমার কন্টেন্ট HLS বা Smooth Stream প্রোটোকল ব্যবহার করে না, এটি আমার অ্যাপ্লিকেশনকে কীভাবে প্রভাবিত করে?

যদি আপনার কন্টেন্ট লাইব্রেরি এই স্ট্রিমিং প্রোটোকলগুলির কোনওটিই ব্যবহার না করে, তাহলে মাইগ্রেশনের ফলে আপনার উপর কোনও প্রভাব পড়বে না। আপনার অ্যাপ্লিকেশনে কোনও পরিবর্তনের প্রয়োজন নেই।