টুর্নামেন্ট ম্যানেজার (TM) পাবলিক API 3য় পক্ষের ডেভেলপারদের টুর্নামেন্ট ম্যানেজার সফ্টওয়্যারের সাথে ইন্টারঅপারেটিং টুল এবং ইন্টিগ্রেশন তৈরি করতে দেয়। কিছু ধরণের ইন্টিগ্রেশন (যেমন, ভিডিও বা ডিসপ্লে সুইচার) অনুমোদিত, এবং অন্যগুলি (যেমন, বিকল্প ম্যাচ টাইমার প্রদর্শন) নিষিদ্ধ৷ এই নিবন্ধটি TM পাবলিক API এর একটি ওভারভিউ এবং আরও ব্যাপক তথ্যের একটি লিঙ্ক প্রদান করে।
TM পাবলিক API কি?
- একটি API হল নিয়ম এবং সরঞ্জামগুলির একটি সেট যা বিভিন্ন সফ্টওয়্যার অ্যাপ্লিকেশনগুলিকে একে অপরের সাথে যোগাযোগ করার অনুমতি দেয়। TM পাবলিক API-এর লক্ষ্য হল VEX সম্প্রদায়ের উন্নত সদস্যদের তাদের নিজস্ব টুর্নামেন্ট ম্যানেজার "এক্সটেনশন" বা "অ্যাড-অন" বিকাশ করার জন্য একটি আনুষ্ঠানিকভাবে-স্বীকৃত সুযোগ প্রদান করা।
- উৎসাহিত/অনুমতিপ্রাপ্ত ইন্টিগ্রেশনের উদাহরণগুলির মধ্যে রয়েছে:
- স্বয়ংক্রিয়ভাবে রেকর্ডিং এবং/অথবা স্বতন্ত্র প্রতিযোগিতার ম্যাচ আপলোড করা
- সক্রিয় ক্ষেত্রের সাথে যুক্ত একটি ক্যামেরা নির্বাচন করতে একটি ভিডিও সুইচার নিয়ন্ত্রণ করা
- ম্যাক্রোপ্যাড সমর্থন যোগ করা হচ্ছে
- সক্রিয় ক্ষেত্রের দিকে নির্দেশ করতে একটি PTZ ক্যামেরা নিয়ন্ত্রণ করা
- স্বয়ংক্রিয়ভাবে দর্শকদের ডিসপ্লে স্ক্রীন নির্বাচন বিভিন্ন শর্তের উপর ভিত্তি করে পরিবর্তন করা
- একটি হাস্যকরভাবে বড় "ম্যাচ শুরু" বোতাম তৈরি করা
- টিএম পাবলিক এপিআই তার প্রাথমিক পর্যায়ে রয়েছে, এবং কোনো ধরনের ওয়ারেন্টি ছাড়াই "যেমন-যেমন" প্রদান করা হয়েছে। যদিও আমরা ভবিষ্যতে সামঞ্জস্য বজায় রাখার আশা করি, আমরা যে কোনো সময় API পরিবর্তন বা বন্ধ করার অধিকার সংরক্ষণ করি।
কোন কার্যকারিতা উপলব্ধ?
- ম্যাচের সময়সূচী / ফলাফল
- র্যাঙ্কিং
- দক্ষতা ফলাফল
- ইভেন্ট স্ট্রীম (যেমন, যে মুহূর্ত যখন ম্যাচগুলি মাঠে সারিবদ্ধ হয়, ম্যাচ শুরু হয়, ইত্যাদি)
- বেসিক ম্যাচ কন্ট্রোল কমান্ড (যেমন, শুরু/স্টপ, পরের ম্যাচের সারি)
কোন কার্যকারিতা উপলব্ধ নয়?
- যেকোন কিছু "লিখুন" বা "সম্পাদনা" সম্পর্কিত
- স্কোর সম্পাদনা বা জমা দেওয়া
- ম্যাচ চলাকালীন রিয়েল-টাইম তথ্য (যেমন, লাইভ স্কোরিং)
- দলের তথ্য সম্পাদনা
- ইভেন্ট কনফিগারেশন পরিবর্তন করা (যেমন, ফিল্ড সেট, ম্যাচের সময়সূচী তৈরি করা ইত্যাদি)
আমি একজন ইভেন্ট পার্টনার; আমি যদি আমার ইভেন্টে তৃতীয় পক্ষের সরঞ্জামগুলি ব্যবহার করতে চাই তবে আমি কীভাবে API সক্ষম করব?
- টুর্নামেন্ট ম্যানেজার খুলুন এবং টুল মেনু নির্বাচন করুন, তারপরে বিকল্পগুলি। অপশন উইন্ডো খোলে, ওয়েব পাবলিশিং বিভাগ নির্বাচন করুন। "স্থানীয় TM API সক্ষম করুন" চেকবক্সটি চেক করুন এবং পরিবর্তনগুলি সংরক্ষণ করুন৷
- প্রতিবার একটি নতুন ইভেন্ট তৈরি করার সময় এটি করা দরকার।
আমি একজন বিকাশকারী; আমি কিভাবে TM API দিয়ে বিকাশ শুরু করব?
- আরও তথ্য টুর্নামেন্ট ম্যানেজার পাবলিক API গাইডএ পাওয়া যাবে।
- শুরু করতে, এই লিঙ্ক -এ একটি API শংসাপত্রের অনুরোধ জমা দিন এবং আপনি কী কাজ করছেন সে সম্পর্কে আমাদের বলুন। চিন্তা করবেন না; যতক্ষণ না আপনার উদ্দিষ্ট আবেদনটি নীচে তালিকাভুক্ত নির্দেশিকাগুলির মধ্যে পড়ে, ততক্ষণ এটি অনুমোদিত হওয়া উচিত। এটি নিশ্চিত করতে সাহায্য করবে যে আপনি এমন কিছুতে উন্নয়ন শক্তি লাগাচ্ছেন না যা পরে অনুমতি দেওয়া হবে না!
নিয়ম & প্রবিধান
- তৃতীয় পক্ষের অ্যাপ্লিকেশনগুলিকে অবশ্যই TM পাবলিক API গাইডে তালিকাভুক্ত সমস্ত প্রযুক্তিগত প্রয়োজনীয়তা অনুসরণ করতে হবে (যেমন, অনুরোধ স্বাক্ষর, অ্যাপ আইডি, API কী, ইত্যাদি)
- ব্যবহারকারীকে ম্যানুয়ালি "অপ্ট-ইন" করতে হবে বা টুলস > সেটিংস > ওয়েব পাবলিশিং > "স্থানীয় TM API সক্ষম করুন" এর মাধ্যমে ম্যানুয়ালি অ্যাড-অন সক্ষম করতে হবে৷
- নিম্নলিখিত জিনিসগুলি বিটা API-তে প্রযুক্তিগতভাবে সম্ভব হতে পারে, কিন্তু স্পষ্টভাবে নিষিদ্ধ। এই নির্দেশিকাগুলি লঙ্ঘন করে পাওয়া অ্যাপ্লিকেশনগুলি অক্ষম করা হবে এবং তাদের API শংসাপত্রগুলি প্রত্যাহার করা হবে৷
- API এর ইভেন্ট স্ট্রীমে থাকা তথ্য ব্যতীত যেকোন ধরণের ম্যাচ টাইমপ্রদর্শন করা বা ম্যাচের সময় সম্পর্কিত কিছু পরিবর্তন করা।
- সঠিক সময় রাখা, এবং সমস্ত সম্ভাব্য ডিভাইস জুড়ে সঠিকভাবে সিঙ্ক্রোনাইজ করা, একটি আশ্চর্যজনক জটিল চ্যালেঞ্জ যা মূল TM কোডবেসের অনেক অংশ জুড়ে জড়িত।
- একটি পাবলিক-ফেসিং API এর মাধ্যমে এটিতে অ্যাক্সেস প্রদান করার ফলে কী অনিচ্ছাকৃত পরিণতি হতে পারে তা ভবিষ্যদ্বাণী করা অসম্ভব, এবং আমরা ইপি এবং দলগুলিকে এমন একটি অবস্থানে রাখতে চাই না যেখানে তারা নিশ্চিত নয় যে তারা প্রদর্শিত সময়কে বিশ্বাস করতে পারে কিনা তাদের পর্দা।
-
বিদ্যমান কার্যকারিতা পুনরায় তৈরি করা (যেমন, আপনার নিজের "TM মোবাইল" তৈরি করা)
- একটি ধারাবাহিক মূল ইভেন্ট অভিজ্ঞতা বজায় রাখা হল REC ফাউন্ডেশন ইভেন্ট মডেলের একটি মৌলিক নীতি। দলগুলিকে বিশ্বাস করতে সক্ষম হওয়া উচিত যে তাদের ইভেন্টে ব্যবহৃত মৌলিক সরঞ্জামগুলি অন্য যে কোনও জায়গায় ব্যবহৃত হওয়ার মতোই, এবং একটি ইভেন্টে অভিজ্ঞতাসম্পন্ন স্বেচ্ছাসেবকরা ন্যূনতম প্রশিক্ষণের সাথে অন্য ইভেন্টে ঝাঁপিয়ে পড়তে পারে-সেটি লিগের সবচেয়ে ছোট ইভেন্ট হোক বা বৃহত্তম স্বাক্ষর ইভেন্ট!
- বিদ্যমান ফাংশনকে কীভাবে উন্নত করা যেতে পারে সে সম্পর্কে আপনার ধারণা থাকলে, আমাদের সরাসরি জানান! যে পরিবর্তনগুলি সত্যিই একটি ভাল ব্যবহারকারীর অভিজ্ঞতা প্রদান করে তা সরাসরি TM-এ লেখা উচিত এবং সমস্ত ইভেন্টের জন্য উপলব্ধ।
- যেকোনো দর্শক প্রদর্শনপরিবর্তন করা বা পুনরায় তৈরি করা
- উপরে উল্লিখিত সামঞ্জস্যপূর্ণ নোট ছাড়াও, অফিসিয়াল অডিয়েন্স ডিসপ্লেতে অন্তর্ভুক্ত বিষয়বস্তু হল REC ফাউন্ডেশন স্পনসর, অ্যাক্সেসিবিলিটি গ্রুপ এবং মার্কেটিং/ব্র্যান্ড ম্যানেজমেন্ট টিমের মধ্যে ক্রিটিক্যাল ডিজাইন & ভেটিং প্রক্রিয়ার ফলাফল।
- যদিও প্রদর্শন পরিবর্তনগুলি একটি একক ইভেন্টের পরিপ্রেক্ষিতে নির্দোষ বলে মনে হতে পারে, তবে সেগুলি প্রায়শই অনিচ্ছাকৃত পরিণতি হতে পারে যা REC ফাউন্ডেশনকে বৃহত্তর স্কেলে প্রভাবিত করে (যেমন, স্পনসরশিপ চুক্তি বা কপিরাইটযুক্ত চিত্র ব্যবহারের সীমাবদ্ধতা)।
- অফিসিয়াল ওপেন এপিআই প্রোটোকলএর বাইরে টুর্নামেন্ট ম্যানেজার এর যেকোনো অভ্যন্তরীণ উপাদান অ্যাক্সেস বা পরিবর্তন করা
- তৃতীয় পক্ষের পরিবর্তনগুলি, যখন অনানুষ্ঠানিকভাবে তৈরি করা হয়, তখন ইভেন্টের অখণ্ডতার সাথে আপস করার সম্ভাব্য ঝুঁকি তৈরি করে। অফিসিয়াল API এন্ট্রি পয়েন্টগুলি ইচ্ছাকৃতভাবে তৃতীয় পক্ষের এক্সটেনশনগুলির জন্য একটি পরিচিত পথ হিসাবে তৈরি করা হয়েছে যা এই ঝুঁকি কমিয়ে বা দূর করে।
- এই চ্যানেলগুলির বাইরের পরিবর্তনগুলি, এই নির্দেশিকাগুলির লঙ্ঘন হওয়া ছাড়াও, ইপি বা দলগুলিকে এমন অবস্থানে রাখার ঝুঁকি নিতে পারে যেখানে তারা তাদের ইভেন্ট চালানো সফ্টওয়্যারটিকে বিশ্বাস করতে পারে না৷
- API এর ইভেন্ট স্ট্রীমে থাকা তথ্য ব্যতীত যেকোন ধরণের ম্যাচ টাইমপ্রদর্শন করা বা ম্যাচের সময় সম্পর্কিত কিছু পরিবর্তন করা।
- দ্রষ্টব্য: এটি আমাদের জন্যও অনাবিষ্কৃত অঞ্চল! কমিউনিটির TM টুলস সম্পর্কে আমাদের কিছু ধারণা থাকতে পারে, কিন্তু আপনার সৃজনশীলতা কখনই আমাদের প্রত্যাশা ছাড়িয়ে যেতে পারে না। সুতরাং, এই নির্দেশিকাগুলি সম্ভবত সময়ের সাথে সাথে বিবর্তিত হবে কারণ TM টুলস প্রোগ্রামটি প্রসারিত হবে এবং আমরা এটি থেকে কী আসে তা দেখতে শুরু করি!
- একটি অনুস্মারক হিসাবে, একটি অফিসিয়াল যোগ্যতা ইভেন্টে অননুমোদিত বা বেআইনিভাবে পরিবর্তিত সফ্টওয়্যার (অর্থাৎ, এই নির্দেশিকাগুলির যেকোনো একটি লঙ্ঘন করে এমন সফ্টওয়্যার) ব্যবহার কঠোরভাবে নিষিদ্ধ।
- বিকাশকারীদের জন্য, এর ফলে তাদের API শংসাপত্রগুলি প্রত্যাহার করা হবে এবং তাদের অ্যাপ্লিকেশনগুলি অক্ষম করা হবে৷
- ছাত্র বা দলের অন্যান্য সদস্যদের জন্য, এটি REC ফাউন্ডেশন কোড অফ কন্ডাক্টএর লঙ্ঘন হিসাবে বিবেচিত হবে।
- ইভেন্ট অংশীদারদের জন্য, এটি ইভেন্ট শ্রেষ্ঠত্বএর প্রতি প্রতিশ্রুতির লঙ্ঘন হিসাবে বিবেচিত হবে।