يوفّر الصف MobileAds إعدادات عامة لحزمة "SDK لعرض الإعلانات على الأجهزة الجوّالة".
التحكّم في مستوى صوت إعلان الفيديو
إذا كان تطبيقك يتضمّن عناصر تحكّم في مستوى الصوت (مثل مستويات مخصّصة للموسيقى أو المؤثرات الصوتية)، فإنّ الإفصاح عن مستوى الصوت في التطبيق لحزمة "SDK لإعلانات Google على الأجهزة الجوّالة" يتيح لإعلانات الفيديو مراعاة إعدادات مستوى الصوت في التطبيق. يضمن ذلك عرض إعلانات الفيديو للمستخدمين بمستوى الصوت المتوقّع.
يحدّد مستوى صوت الجهاز، الذي يتم التحكّم فيه من خلال أزرار مستوى الصوت أو شريط تمرير مستوى الصوت على مستوى نظام التشغيل، مستوى صوت إخراج الصوت من الجهاز. ومع ذلك، يمكن للتطبيقات ضبط مستويات الصوت بشكل مستقل بما يتناسب مع مستوى صوت الجهاز لتخصيص تجربة الصوت.
يمكنك إرسال مستوى صوت التطبيق النسبي إلى حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة من خلال استدعاء الطريقة SetApplicationVolume(). تتراوح قيم مستوى صوت الإعلان الصالحة بين 0.0 (صامت) و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 (مستوى صوت الجهاز الحالي)، ولا يتم كتم صوت التطبيق.
تاريخ التعديل الأخير: 2025-09-02 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-09-02 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe \u003ccode\u003eMobileAds\u003c/code\u003e class allows you to manage global settings for the Mobile Ads SDK, including video ad volume.\u003c/p\u003e\n"],["\u003cp\u003eYou can control the volume of video ads relative to your app's volume using \u003ccode\u003eSetApplicationVolume()\u003c/code\u003e for a better user experience.\u003c/p\u003e\n"],["\u003cp\u003eMuting or lowering app volume can impact video ad eligibility and potentially reduce ad revenue, so use volume controls judiciously and only when reflecting actual user preferences.\u003c/p\u003e\n"]]],["The `MobileAds` class allows control over video ad volume. Apps with custom volume controls can set the relative app volume using `SetApplicationVolume()` with values from `0.0` (silent) to `1.0` (device volume). Muting the app is possible via `SetApplicationMuted(true)`. Default app volume is `1`, and the app is not muted. Lowering volume or muting reduces video ad eligibility and may lower revenue, thus these APIs should only reflect user volume choices.\n"],null,[]]