הגדרות גלובליות

המחלקות MobileAds מספקות הגדרות גלובליות ל-Mobile Ads SDK.

שליטה בעוצמת הקול של מודעות וידאו

אם לאפליקציה יש פקדי עוצמת קול משלה (כמו לחצנים מותאמים אישית לשליטה בעוצמת הקול של המוזיקה או האפקטים), חשיפת עוצמת הקול של האפליקציה ל-Google Mobile Ads SDK מאפשרת למודעות וידאו לפעול בהתאם להגדרות עוצמת הקול של האפליקציה. כך המשתמשים יקבלו מודעות וידאו עם עוצמת הקול הצפויה.

עוצמת הקול של המכשיר, שנשלטת באמצעות לחצני עוצמת הקול או פס עוצמת הקול ברמת מערכת ההפעלה, קובעת את עוצמת הקול של פלט האודיו של המכשיר. עם זאת, אפליקציות יכולות לשנות את עוצמת הקול באופן עצמאי ביחס לעוצמת הקול של המכשיר, כדי להתאים את חוויית האודיו.

אפשר לדווח על עוצמת הקול היחסית של האפליקציה ל-Google Mobile Ads SDK באמצעות קריאה לשיטה SetApplicationVolume(). הערכים התקינים של עוצמת הקול של המודעה נעים בין 0.0 (silent) לבין 1.0 (עוצמת הקול הנוכחית של המכשיר). דוגמה לאופן הדיווח של נפח האפליקציה היחסי ל-SDK:

    // Set app volume to be half of current device volume.
    MobileAds.SetApplicationVolume(0.5f);

כדי להודיע ל-SDK שעוצמת הקול של האפליקציה הושתקה, משתמשים בשיטה SetApplicationMuted():

    // Set app to be muted.
    MobileAds.SetApplicationMuted(true);

כברירת מחדל, עוצמת הקול של האפליקציה מוגדרת ל1 (עוצמת הקול הנוכחית במכשיר), והאפליקציה לא מושתקת.