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

ytgame

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

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

গণনা

Const SdkErrorType

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

প্লেয়াররা যদি ক্রিটিক্যাল ফ্লোতে থাকে তাহলে পরবর্তী সময়ে আবার চেষ্টা করতে বলুন।
INVALID_ PARAMS
এপিআই অবৈধ পরামিতি সহ কল ​​করা হয়েছিল।
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
YouTube Playables SDK সংস্করণ।
উদাহরণ 
// Prints the SDK version to console. Do not do this in production.
console.log(ytgame.SDK_VERSION);

ytgame.SdkError

Error প্রসারিত করে
YouTube Playables SDK থ্রো করা ত্রুটি বস্তু।

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

বৈশিষ্ট্য

ত্রুটির প্রকার

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

ytgame.ads

🧪 পাবলিক প্রিভিউ এপিআই: বিজ্ঞপ্তি ছাড়াই পরিবর্তন করতে হবে।

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

ফাংশন

অনুরোধ ইন্টারস্টিশিয়াল অ্যাড

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

🧪 পাবলিক প্রিভিউ এপিআই: বিজ্ঞপ্তি ছাড়াই পরিবর্তন করতে হবে।

বিজ্ঞাপন দেখানো হয়েছে কিনা সে সম্পর্কে কোন গ্যারান্টি দেয় না।
উদাহরণ 
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 > একটি প্রতিশ্রুতি যা একটি সফল অনুরোধে সমাধান করে বা একটি অসফল অনুরোধকে প্রত্যাখ্যান/নিক্ষেপ করে।

ytgame.engagement

খেলোয়াড়ের ব্যস্ততার সাথে সম্পর্কিত ফাংশন এবং বৈশিষ্ট্য।
ইন্টারফেস
Content
কন্টেন্ট অবজেক্ট গেমটি YouTube-এ পাঠায়।
Score
গেমটি YouTube-এ যে স্কোর অবজেক্ট পাঠায়।
ফাংশন
open YTContent
প্রদত্ত ভিডিও আইডির সাথে সম্পর্কিত বিষয়বস্তু খুলতে YouTube-কে অনুরোধ করে৷
send Score
ইউটিউবে একটি স্কোর পাঠায়।

ফাংশন

openYTC সামগ্রী

openYTContent ( content : Content ) : Promise < void >
প্রদত্ত ভিডিও আইডির সাথে সম্পর্কিত বিষয়বস্তু খুলতে YouTube-কে অনুরোধ করে৷

সাধারণত, এটি ওয়েবে একটি নতুন ট্যাবে এবং মোবাইলের মিনিপ্লেয়ারে ভিডিওটি খুলবে৷
উদাহরণ 
async function showVideo(videoID: string) {
  try {
    await ytgame.engagement.openYTContent({ id: videoID });
    // Request successful, do something else.
  } catch (error) {
    // Handle errors, retry logic, etc.
    // Note that error may be undefined.
  }
}
পরামিতি
content : Content YouTube-এ খোলার বিষয়বস্তু।
রিটার্নস
Promise < void > একটি প্রতিশ্রুতি যা সফল হলে সমাধান করে এবং ব্যর্থ হলে ytgame.SdkError দিয়ে প্রত্যাখ্যান/থ্রো করে।

সেন্ডস্কোর

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 YouTube-এ পাঠানোর স্কোর।
রিটার্নস
Promise < void > একটি প্রতিশ্রুতি যা সফল হলে সমাধান করে এবং ব্যর্থ হলে ytgame.SdkError দিয়ে প্রত্যাখ্যান/থ্রো করে।

ytgame.engagement.Content

কন্টেন্ট অবজেক্ট গেমটি YouTube-এ পাঠায়।
বৈশিষ্ট্য
id
ভিডিওর আইডি আমরা খুলতে চাই।

বৈশিষ্ট্য

আইডি

id : string
ভিডিওর আইডি আমরা খুলতে চাই।

ytgame.engagement.Score

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

বৈশিষ্ট্য

মান

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

ytgame.game

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

ফাংশন

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

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

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

খেলার জন্য প্রস্তুত

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

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

লোড ডেটা

loadData ( ) : Promise < string >
একটি ধারাবাহিক স্ট্রিং আকারে YouTube থেকে গেম ডেটা লোড করে৷

গেমটিকে অবশ্যই স্ট্রিং এবং একটি অভ্যন্তরীণ বিন্যাসের মধ্যে যেকোনো পার্সিং পরিচালনা করতে হবে।
উদাহরণ 
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 দিয়ে প্রত্যাখ্যান করে।

ytgame.health

ফাংশন এবং বৈশিষ্ট্য গেম স্বাস্থ্য সম্পর্কিত.
ফাংশন
log Error
YouTube এ একটি ত্রুটি লগ করে৷
log Warning
ইউটিউবে একটি সতর্কতা লগ করুন৷

ফাংশন

logError

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

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

লগ ওয়ার্নিং

logWarning ( ) : void
ইউটিউবে একটি সতর্কতা লগ করুন৷

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

ytgame.system

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

ফাংশন

ভাষা পান

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

ব্যবহারকারীর ভাষা বা লোকেল নির্ধারণ করতে অন্য ফাংশন ব্যবহার করবেন না বা ক্লাউড সেভ-এ তাদের ভাষা পছন্দ সঞ্চয় করবেন না। পরিবর্তে, ব্যবহারকারীর অভিজ্ঞতা 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 )
অডিও সেটিংস পরিবর্তন ইভেন্ট YouTube থেকে বহিস্কার করা হলে ট্রিগার হতে একটি কলব্যাক সেট করে৷

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

অনপজ

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

অনপজ সব ধরনের বিরতির জন্য বলা হয়, যার মধ্যে ব্যবহারকারী কখন গেম থেকে বেরিয়ে যায়। খেলা আবার শুরু হবে তার কোন নিশ্চয়তা নেই।
উদাহরণ 
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 ) কলব্যাক আনসেট করার জন্য একটি ফাংশন যা সাধারণত অব্যবহৃত হয়।