ग्लोबल सेटिंग

MobileAds क्लास, GMA Next Gen SDK के लिए ग्लोबल सेटिंग उपलब्ध कराती है.

वीडियो विज्ञापन के वॉल्यूम को कंट्रोल करना

अगर आपके ऐप्लिकेशन में अपनी वॉल्यूम कंट्रोल (जैसे कि कस्टम म्यूज़िक या साउंड इफ़ेक्ट वॉल्यूम) है, तो GMA Next Gen SDK को ऐप्लिकेशन के वॉल्यूम की जानकारी देने से, वीडियो विज्ञापनों में ऐप्लिकेशन के वॉल्यूम की सेटिंग लागू की जा सकती हैं. इससे यह पक्का होता है कि उपयोगकर्ताओं को वीडियो विज्ञापन, उम्मीद के मुताबिक ऑडियो वॉल्यूम के साथ दिखें.

डिवाइस का वॉल्यूम, आवाज़ कम या ज़्यादा करने वाले बटन या ओएस-लेवल के वॉल्यूम स्लाइडर से कंट्रोल किया जाता है. इससे डिवाइस के ऑडियो आउटपुट का वॉल्यूम तय होता है. हालांकि, ऐप्लिकेशन ऑडियो के अनुभव को बेहतर बनाने के लिए, डिवाइस के वॉल्यूम के हिसाब से वॉल्यूम लेवल को अलग-अलग तरीके से कम या ज़्यादा कर सकते हैं. ऐप्लिकेशन खोलने पर दिखने वाले विज्ञापन, बैनर, इंटरस्टीशियल, इनाम वाले विज्ञापन, और इनाम वाले इंटरस्टीशियल विज्ञापन के फ़ॉर्मैट के लिए, SDK को ऐप्लिकेशन के वॉल्यूम की जानकारी दी जा सकती है. इसके लिए, स्टैटिक setUserControlledAppVolume() तरीके का इस्तेमाल करें. विज्ञापन के वॉल्यूम की मान्य वैल्यू, 0.0 (साइलेंट) से लेकर 1.0 (डिवाइस का मौजूदा वॉल्यूम) तक होती हैं. यहां एक उदाहरण दिया गया है, जिसमें बताया गया है कि एसडीके को ऐप्लिकेशन के वॉल्यूम की जानकारी कैसे दी जाती है:

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)

  val backgroundScope = CoroutineScope(Dispatchers.IO)
  backgroundScope.launch {
    // Initialize GMA Next Gen SDK on a background thread.
    MobileAds.initialize(
      this@MainActivity,
      // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
      InitializationConfig.Builder("SAMPLE_APP_ID").build()
    ) {}
    
    // Set app volume to be half of current device volume.
    MobileAds.setUserControlledAppVolume(0.5f)
  }
}

Java

@Override
protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);

  new Thread(
          () -> {
            // Initialize GMA Next Gen SDK on a background thread.
            MobileAds.initialize(
                this,
                // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
                new InitializationConfig.Builder("SAMPLE_APP_ID")
                    .build(),
                initializationStatus -> {
                });
            
            // Set app volume to be half of current device volume.
            MobileAds.setUserControlledAppVolume(0.5f);
          })
      .start();
}

ऐप्लिकेशन का वॉल्यूम बंद होने की जानकारी एसडीके को देने के लिए, setUserMutedApp() तरीके का इस्तेमाल करें:

Kotlin

MobileAds.setUserMutedApp(true)

Java

MobileAds.setUserMutedApp(true);

डिफ़ॉल्ट रूप से, ऐप्लिकेशन का वॉल्यूम 1 (डिवाइस का मौजूदा वॉल्यूम) पर सेट होता है. साथ ही, ऐप्लिकेशन म्यूट नहीं होता.

ध्यान दें: जिन वीडियो विज्ञापनों को म्यूट किए गए ऑडियो के साथ नहीं दिखाया जा सकता उन्हें विज्ञापन अनुरोधों के लिए नहीं दिखाया जाता. ये अनुरोध तब किए जाते हैं, जब ऐप्लिकेशन का वॉल्यूम म्यूट किया गया हो या 0 पर सेट किया गया हो. इससे, वीडियो विज्ञापनों के बड़े पूल के किसी सबसेट को दिखाने पर पाबंदी लग सकती है.

कुकी के लिए सहमति

अगर आपके ऐप्लिकेशन के लिए कुछ खास ज़रूरी शर्तें हैं, तो आपके पास वैकल्पिक SharedPreferences gad_has_consent_for_cookies को सेट करने का विकल्प होता है. जब gad_has_consent_for_cookies की प्राथमिकता शून्य पर सेट होती है, तब SDK, विज्ञापनों को सीमित तौर पर दिखाए जाने की सुविधा (एलटीडी) चालू कर देगा.

Kotlin

val sharedPrefs = PreferenceManager.getDefaultSharedPreferences(context)
// Set the value to 0 to enable limited ads.
sharedPrefs.edit().putInt("gad_has_consent_for_cookies", 0).apply()

Java

Context activity = getActivity();
SharedPreferences sharedPreferences =
  PreferenceManager.getDefaultSharedPreferences(activity);
// Set the value to 0 to enable limited ads.
sharedPreferences.edit().putInt("gad_has_consent_for_cookies", 0).apply();