YouTube Playables SDK রেফারেন্স

ytgame সম্পর্কে

YouTube Playables SDK-এর জন্য শীর্ষ-স্তরের নেমস্পেস।

এটি বর্তমান উইন্ডোতে একটি বিশ্বব্যাপী স্কোপড ভেরিয়েবল। আপনার এই ভেরিয়েবলটি ওভাররাইড করা উচিত নয় ।
নামস্থান
ads
🧪 পাবলিক প্রিভিউ API: বিজ্ঞপ্তি ছাড়াই পরিবর্তনের বিষয়।
engagement
খেলোয়াড়দের অংশগ্রহণের সাথে সম্পর্কিত কার্যাবলী এবং বৈশিষ্ট্য।
game
জেনেরিক গেম আচরণের সাথে সম্পর্কিত ফাংশন এবং বৈশিষ্ট্য।
health
খেলার স্বাস্থ্যের সাথে সম্পর্কিত কার্যাবলী এবং বৈশিষ্ট্য।
system
ইউটিউব সিস্টেমের সাথে সম্পর্কিত ফাংশন এবং বৈশিষ্ট্য।
গণনা
Sdk Error Type
YouTube Playables SDK যে ধরণের ত্রুটি করে।
ক্লাস
Sdk Error
YouTube Playables SDK যে ত্রুটির বস্তুটি ছুঁড়ে দেয়।
ভেরিয়েবল
IN_ PLAYABLES_ ENV
গেমটি প্লেএবলস পরিবেশের মধ্যে চলছে কিনা।
SDK_ VERSION
ইউটিউব প্লেএবলস এসডিকে সংস্করণ।
আরো দেখুন

গণনা

Const এসডিকে ত্রুটির ধরণ

SdkErrorType
YouTube Playables SDK যে ধরণের ত্রুটি করে।
গণনার সদস্যগণ
API_ UNAVAILABLE
APIটি সাময়িকভাবে অনুপলব্ধ ছিল।

খেলোয়াড়রা যদি জটিল প্রবাহে থাকে তবে পরে আবার চেষ্টা করতে বলুন।
INVALID_ PARAMS
API টি অবৈধ প্যারামিটার সহ কল ​​করা হয়েছিল।
SIZE_ LIMIT_ EXCEEDED
APIটি এমনভাবে কল করা হয়েছিল যেখানে প্যারামিটারগুলি আকার সীমা অতিক্রম করেছিল।
UNKNOWN
ত্রুটির ধরণ অজানা।

ভেরিয়েবল

Const IN_PLAYABLES_ENV

IN_PLAYABLES_ENV : boolean
গেমটি Playables পরিবেশের মধ্যে চলছে কিনা। আপনি এটি ব্যবহার করে নির্ধারণ করতে পারেন যে শুধুমাত্র Playables এর ভিতরে উপলব্ধ বৈশিষ্ট্যগুলি সক্ষম বা অক্ষম করা উচিত কিনা। SDK আসলে লোড হয়েছে কিনা তা নিশ্চিত করার জন্য ytgame চেক করার সাথে এই চেকটি একত্রিত করুন।
উদাহরণ 
const inPlayablesEnv = typeof ytgame !== "undefined" && ytgame.IN_PLAYABLES_ENV;
// An example of where you may want to fork behavior for saving data.
if (ytgame?.IN_PLAYABLES_ENV) {
  ytgame.game.saveData(dataStr);
} else {
  window.localStorage.setItem("SAVE_DATA", dataStr);
}

Const SDK_VERSION

SDK_VERSION : string
ইউটিউব প্লেএবলস এসডিকে সংস্করণ।
উদাহরণ 
// Prints the SDK version to console. Do not do this in production.
console.log(ytgame.SDK_VERSION);

ytgame.Sdk ত্রুটি

Error প্রসারিত করে
YouTube Playables SDK যে ত্রুটির বস্তুটি ছুঁড়ে দেয়।

SdkError অবজেক্টটি Error এর একটি শিশু এবং এতে একটি অতিরিক্ত ক্ষেত্র রয়েছে।
নির্মাতারা
constructor
বৈশিষ্ট্য
error Type
ত্রুটির ধরণ।
message
name
stack ?

বৈশিষ্ট্য

ত্রুটির ধরণ

errorType : SdkErrorType
ত্রুটির ধরণ।

ytgame.ads সম্পর্কে

🧪 পাবলিক প্রিভিউ API: বিজ্ঞপ্তি ছাড়াই পরিবর্তনের বিষয়।

বিজ্ঞাপনের সাথে সম্পর্কিত ফাংশন এবং বৈশিষ্ট্য।
ফাংশন
request Interstitial Ad
একটি ইন্টারস্টিশিয়াল বিজ্ঞাপন দেখানোর অনুরোধ করে।
request Rewarded Ad
একটি নির্দিষ্ট ধরণের পুরষ্কারের জন্য একটি পুরষ্কৃত বিজ্ঞাপন দেখানোর অনুরোধ করে।

ফাংশন

অনুরোধ ইন্টারস্টিশিয়াল বিজ্ঞাপন

requestInterstitialAd ( ) : Promise < void >
Experimental দেখানোর জন্য একটি ইন্টারস্টিশিয়াল বিজ্ঞাপনের অনুরোধ করে।

🧪 পাবলিক প্রিভিউ API: বিজ্ঞপ্তি ছাড়াই পরিবর্তনের বিষয়।

বিজ্ঞাপনটি দেখানো হয়েছে কিনা সে সম্পর্কে কোনও গ্যারান্টি দেয় না। বিজ্ঞাপন দেখার জন্য খেলোয়াড়দের পুরস্কৃত করতে এই API ব্যবহার করবেন না।
উদাহরণ 
try {
  await ytgame.ads.requestInterstitialAd();
  // Ad request successful, do something else.
} catch (error) {
  // Handle errors, retry logic, etc.
  // Note that error may be undefined.
}
রিটার্নস
Promise < void > একটি প্রতিশ্রুতি যা একটি সফল অনুরোধের সমাধান করে অথবা একটি ব্যর্থ অনুরোধ প্রত্যাখ্যান/নিক্ষেপ করে।

requestRewardedAd সম্পর্কে

requestRewardedAd ( rewardId : string ) : Promise < boolean >
Experimental একটি নির্দিষ্ট ধরণের পুরষ্কারের জন্য একটি পুরস্কৃত বিজ্ঞাপন দেখানোর অনুরোধ করে।

🧪 পাবলিক প্রিভিউ API: বিজ্ঞপ্তি ছাড়াই পরিবর্তনের বিষয়।

বিজ্ঞাপনটি দেখানো হয়েছে কিনা সে সম্পর্কে কোনও গ্যারান্টি দেয় না।
উদাহরণ 
try {
  const isRewardEarned = await ytgame.ads.requestRewardedAd("21403813-2e22-4316-a8b2-7d4f52a6f6fb");
  // Handle reward being earned or not.
} catch (error) {
  // Handle errors, retry logic, etc.
  // Note that error may be undefined.
}
পরামিতি
rewardId : string প্রয়োজনীয়। দাবিযোগ্য পুরস্কারের ধরণটি অনন্যভাবে শনাক্ত করে এমন একটি শনাক্তকারী। প্রতিটি ধরণের পুরস্কারের জন্য আপনাকে একটি অনন্য আইডি ব্যবহার করতে হবে এবং প্রতিবার সেই নির্দিষ্ট ধরণের পুরস্কার অফার করার সময় একই আইডি পুনরায় ব্যবহার করতে হবে। উদাহরণস্বরূপ:
  • 21403813-2e22-4316-a8b2-7d4f52a6f6fb - "১০০ কয়েন"
  • 7deffcfa2-4312-4893-a13a-a84e0c47a4df - "৩টি জীবন"
  • 121b001a-0c25-4289-88f6-58e3620d938f - "স্তর এড়িয়ে যান"
রিটার্নস
Promise < boolean > একটি প্রতিশ্রুতি যা সফল অনুরোধের ক্ষেত্রে সমাধান করে, যদি ব্যবহারকারী পুরষ্কার পাওয়ার শর্ত পূরণ করে তবে মান সত্য, অথবা যদি তারা না করে তবে মিথ্যা। প্রতিশ্রুতিটি একটি ব্যর্থ অনুরোধ প্রত্যাখ্যান/নিক্ষেপ করে।

অনুসরণ

খেলোয়াড়দের অংশগ্রহণের সাথে সম্পর্কিত কার্যাবলী এবং বৈশিষ্ট্য।
ইন্টারফেস
Score
গেমটি ইউটিউবে যে স্কোর অবজেক্ট পাঠায়।
ফাংশন
send Score
ইউটিউবে একটি স্কোর পাঠায়।

ফাংশন

সেন্ডস্কোর

sendScore ( score : Score ) : Promise < void >
ইউটিউবে একটি স্কোর পাঠায়।

স্কোরটি গেমের অগ্রগতির একটি মাত্রার প্রতিনিধিত্ব করা উচিত। যদি একাধিক মাত্রা থাকে, তাহলে ডেভেলপারকে ধারাবাহিকতার জন্য একটি মাত্রা বেছে নিতে হবে। স্কোরগুলি সাজানো হবে এবং সর্বোচ্চ স্কোরটি YouTube UI-তে প্রদর্শিত হবে যাতে যেকোনো ইন-গেম উচ্চ স্কোর UI এই API এর মাধ্যমে যা পাঠানো হচ্ছে তার সাথে সামঞ্জস্যপূর্ণ হয়।
উদাহরণ 
async function onScoreAwarded(score: number) {
  try {
    await ytgame.engagement.sendScore({ value: score });
    // Score sent successfully, do something else.
  } catch (error) {
    // Handle errors, retry logic, etc.
    // Note that error may be undefined.
  }
}
পরামিতি
score : Score ইউটিউবে পাঠানোর জন্য স্কোর।
রিটার্নস
Promise < void > একটি প্রতিশ্রুতি যা সফল হলে সমাধান হয় এবং ব্যর্থ হলে ytgame.SdkError দিয়ে প্রত্যাখ্যান/নিক্ষেপ করে।

ytgame.engagement.স্কোর

গেমটি ইউটিউবে যে স্কোর অবজেক্ট পাঠায়।
বৈশিষ্ট্য
value
পূর্ণসংখ্যা হিসেবে প্রকাশিত স্কোর মান।

বৈশিষ্ট্য

মূল্য

value : number
পূর্ণসংখ্যা হিসেবে প্রকাশিত স্কোর মান। স্কোরটি সর্বোচ্চ নিরাপদ পূর্ণসংখ্যার চেয়ে কম বা সমান হতে হবে। অন্যথায়, স্কোরটি বাতিল করা হবে।

ytgame.game সম্পর্কে

জেনেরিক গেম আচরণের সাথে সম্পর্কিত ফাংশন এবং বৈশিষ্ট্য।
ফাংশন
first Frame Ready
ইউটিউবকে জানিয়ে দেয় যে গেমটিতে ফ্রেম দেখা শুরু হয়েছে।
game Ready
ইউটিউবকে জানিয়ে দেয় যে গেমটি খেলোয়াড়দের সাথে ইন্টারঅ্যাক্ট করার জন্য প্রস্তুত।
load Data
ইউটিউব থেকে গেমের ডেটা সিরিয়ালাইজড স্ট্রিং আকারে লোড করে।
save Data
সিরিয়ালাইজড স্ট্রিং আকারে YouTube-এ গেমের ডেটা সংরক্ষণ করে।

ফাংশন

প্রথম ফ্রেম প্রস্তুত

firstFrameReady ( ) : void
ইউটিউবকে জানিয়ে দেয় যে গেমটিতে ফ্রেম দেখা শুরু হয়েছে।

গেমটিকে অবশ্যই এই API কল করতে হবে। অন্যথায়, গেমটি ব্যবহারকারীদের দেখানো হবে না। gameReady() firstFrameReady() () কল করতে হবে ।
উদাহরণ 
function onGameInitialized() {
  ytgame.game.firstFrameReady();
}

খেলা প্রস্তুত

gameReady ( ) : void
ইউটিউবকে জানিয়ে দেয় যে গেমটি খেলোয়াড়দের সাথে ইন্টারঅ্যাক্ট করার জন্য প্রস্তুত।

গেমটি ইন্টারঅ্যাক্টেবল হলে অবশ্যই এই API ব্যবহার করতে হবে। লোডিং স্ক্রিন দেখা গেলেও গেমটি এই API ব্যবহার করতে পারবে না । অন্যথায়, গেমটি YouTube সার্টিফিকেশন প্রক্রিয়ায় ব্যর্থ হবে।
উদাহরণ 
function onGameInteractable() {
  ytgame.game.gameReady();
}

লোডডেটা

loadData ( ) : Promise < string >
ইউটিউব থেকে গেমের ডেটা সিরিয়ালাইজড স্ট্রিং আকারে লোড করে।

গেমটিকে স্ট্রিং এবং একটি অভ্যন্তরীণ বিন্যাসের মধ্যে যেকোনো পার্সিং পরিচালনা করতে হবে ।
উদাহরণ 
async function gameSetup() {
  try {
    const data = await ytgame.game.loadData();
    // Load succeeded, do something with data.
  } catch (error) {
    // Handle errors, retry logic, etc.
    // Note that error may be undefined.
  }
}
রিটার্নস
Promise < string > একটি প্রতিশ্রুতি যা লোডিং সফল হলে সম্পূর্ণ হয় এবং ব্যর্থ হলে ytgame.SdkError দিয়ে প্রত্যাখ্যান করা হয়।

ডেটা সংরক্ষণ করুন

saveData ( data : string ) : Promise < void >
সিরিয়ালাইজড স্ট্রিং আকারে YouTube-এ গেমের ডেটা সংরক্ষণ করে।

স্ট্রিংটি অবশ্যই একটি বৈধ, সুগঠিত UTF-16 স্ট্রিং এবং সর্বাধিক 3 MiB হতে হবে। গেমটি স্ট্রিং এবং একটি অভ্যন্তরীণ ফর্ম্যাটের মধ্যে যেকোনো পার্সিং পরিচালনা করবে । প্রয়োজনে, স্ট্রিংটি সুগঠিত কিনা তা পরীক্ষা করতে String.isWellFormed() ব্যবহার করুন।
উদাহরণ 
async function saveGame() {
  try {
    ytgame.game.saveData(JSON.stringify(gameSave));
    // Save succeeded.
  } catch (error) {
    // Handle errors, retry logic, etc.
    // Note that error may be undefined.
  }
}
পরামিতি
data : string
রিটার্নস
Promise < void > একটি প্রতিশ্রুতি যা সংরক্ষণ সফল হলে সমাধান হয় এবং ব্যর্থ হলে ytgame.SdkError দিয়ে প্রত্যাখ্যান করা হয়।

অনুসরণ

খেলার স্বাস্থ্যের সাথে সম্পর্কিত কার্যাবলী এবং বৈশিষ্ট্য।
ফাংশন
log Error
YouTube-এ একটি ত্রুটি লগ করে।
log Warning
YouTube-এ একটি সতর্কতা লগ করে।

ফাংশন

লগ ত্রুটি

logError ( ) : void
YouTube-এ একটি ত্রুটি লগ করে।

দ্রষ্টব্য: এই APIটি সর্বোত্তম প্রচেষ্টা এবং রেট-সীমিত যার ফলে ডেটা ক্ষতি হতে পারে।
উদাহরণ 
function onError() {
  ytgame.health.logError();
}

লগ সতর্কতা

logWarning ( ) : void
YouTube-এ একটি সতর্কতা লগ করে।

দ্রষ্টব্য: এই APIটি সর্বোত্তম প্রচেষ্টা এবং রেট-সীমিত যার ফলে ডেটা ক্ষতি হতে পারে।
উদাহরণ 
function onWarning() {
  ytgame.health.logWarning();
}

ytgame.system সম্পর্কে

ইউটিউব সিস্টেমের সাথে সম্পর্কিত ফাংশন এবং বৈশিষ্ট্য।
ফাংশন
get Language
ব্যবহারকারীর YouTube সেটিংসে BCP-47 ভাষা ট্যাগ আকারে সেট করা ভাষাটি ফেরত পাঠায়।
is Audio Enabled
YouTube সেটিংসে গেম অডিও সক্ষম আছে কিনা তা ফেরত দেয়।
on Audio Enabled Change
ইউটিউব থেকে অডিও সেটিংস পরিবর্তন ইভেন্টটি চালু হলে একটি কলব্যাক ট্রিগার হওয়ার জন্য সেট করে।
on Pause
YouTube থেকে একটি পজ গেম ইভেন্ট চালু হলে কলব্যাক ট্রিগার হওয়ার জন্য সেট করে।
on Resume
YouTube থেকে একটি রিজিউম গেম ইভেন্ট বন্ধ হয়ে গেলে কলব্যাক ট্রিগার হওয়ার জন্য সেট করে।

ফাংশন

ভাষা পান

getLanguage ( ) : Promise < string >
ব্যবহারকারীর YouTube সেটিংসে BCP-47 ভাষা ট্যাগ আকারে সেট করা ভাষাটি ফেরত পাঠায়।

ব্যবহারকারীর ভাষা বা লোকেল নির্ধারণ করতে অন্য কোনও ফাংশন ব্যবহার করবেন না, অথবা ক্লাউড সেভে তাদের ভাষা পছন্দ সংরক্ষণ করবেন না। পরিবর্তে, YouTube জুড়ে ব্যবহারকারীর অভিজ্ঞতা যাতে সামঞ্জস্যপূর্ণ হয় তা নিশ্চিত করতে এই ফাংশনটি ব্যবহার করুন।
উদাহরণ 
const localeTag = await ytgame.system.getLanguage();
// `localeTag` is now set to something like "en-US" or "es-419".
রিটার্নস
Promise < string > একটি প্রতিশ্রুতি যা ভাষা সফল হলে সম্পূর্ণ হয় এবং ব্যর্থ হলে ytgame.SdkError দিয়ে প্রত্যাখ্যান করা হয়।

অডিও সক্ষম করা আছে

isAudioEnabled ( ) : boolean
YouTube সেটিংসে গেম অডিও সক্ষম আছে কিনা তা ফেরত দেয়।

গেমটির অডিও অবস্থা শুরু করার জন্য এটি ব্যবহার করা উচিত ।
উদাহরণ 
function initGameSound() {
  if (ytgame.system.isAudioEnabled()) {
    // Enable game audio.
  } else {
    // Disable game audio.
  }
}
রিটার্নস
boolean অডিও সক্রিয় কিনা তা নির্দেশ করে একটি বুলিয়ান।

onAudioEnabledChange সম্পর্কে

onAudioEnabledChange ( callback : ( ( isAudioEnabled : boolean ) => void ) ) : ( ( ) => void )
ইউটিউব থেকে অডিও সেটিংস পরিবর্তন ইভেন্টটি চালু হলে একটি কলব্যাক ট্রিগার হওয়ার জন্য সেট করে।

গেমটির অডিও অবস্থা আপডেট করার জন্য গেমটিকে অবশ্যই এই API ব্যবহার করতে হবে।
উদাহরণ 
ytgame.system.onAudioEnabledChange((isAudioEnabled) => {
  if (isAudioEnabled) {
    // Enable game audio.
  } else {
    // Disable game audio.
  }
});
পরামিতি
callback : ( ( isAudioEnabled : boolean ) => void ) কলব্যাক ফাংশনটি ট্রিগার করা হবে।
রিটার্নস
( ( ) => void ) সাধারণত অব্যবহৃত কলব্যাক আনসেট করার জন্য একটি ফাংশন।

অনপজ

onPause ( callback : ( ( ) => void ) ) : ( ( ) => void )
YouTube থেকে একটি পজ গেম ইভেন্ট ফায়ার করা হলে একটি কলব্যাক ট্রিগার করার জন্য সেট করে। গেমটিতে একটি ছোট উইন্ডো রয়েছে যা যেকোনো অবস্থাকে বের করে দেওয়ার আগে সংরক্ষণ করে।

onPause হলো সকল ধরণের বিরতির জন্য ব্যবহৃত হয়, যার মধ্যে ব্যবহারকারী যখন গেমটি থেকে বেরিয়ে আসে তখনও অন্তর্ভুক্ত। গেমটি পুনরায় শুরু হবে এমন কোনও গ্যারান্টি নেই।
উদাহরণ 
ytgame.system.onPause(() => {
  pauseGame();
});

function pauseGame() {
  // Logic to pause game state.
}
পরামিতি
callback : ( ( ) => void ) কলব্যাক ফাংশনটি ট্রিগার করা হবে।
রিটার্নস
( ( ) => void ) সাধারণত অব্যবহৃত কলব্যাক আনসেট করার জন্য একটি ফাংশন।

রিজুমে

onResume ( callback : ( ( ) => void ) ) : ( ( ) => void )
YouTube থেকে একটি রিজিউম গেম ইভেন্ট বন্ধ হয়ে গেলে কলব্যাক ট্রিগার হওয়ার জন্য সেট করে।

বিরতি দেওয়ার পর, খেলাটি আবার শুরু হবে কিনা তার কোনও নিশ্চয়তা নেই।
উদাহরণ 
ytgame.system.onResume(() => {
  resumeGame();
});

function resumeGame() {
  // Logic to resume game state.
}
পরামিতি
callback : ( ( ) => void ) কলব্যাক ফাংশনটি ট্রিগার করা হবে।
রিটার্নস
( ( ) => void ) সাধারণত অব্যবহৃত কলব্যাক আনসেট করার জন্য একটি ফাংশন।