إعدادات عامة

يوفر الصف MobileAds إعدادات عامة لـ .

إصدار أحداث الإعلانات على سلسلة التعليمات الرئيسية في Unity

تُطلق الأحداث في سلسلة محادثات مختلفة عن سلسلة المحادثات الرئيسية في Unity. إذا كنت تنفّذ أحداث الإعلانات وتتفاعل مع عناصر Unity، عليك مزامنة الأحداث مع سلسلة التعليمات الرئيسية في Unity.

يمكنك مزامنة أحداث الإعلانات مع سلسلة التعليمات الرئيسية في Unity إما يدويًا أو تلقائيًا من خلال السماح لـ بإجراء المزامنة.

يُنصح بما يلي: مزامنة أحداث الإعلانات يدويًا

لمزامنة أحداث الإعلانات يدويًا، استخدِم الطريقة ExecuteInUpdate في سلسلة التعليمات الرئيسية. يجب استخدام طريقة ExecuteInUpdate عند التفاعل مع عناصر UnityEngine، وعندما تكون السمة RaiseAdEventsOnUnityMainThread غير مفعّلة.

يسجّل المثال التالي سلسلة محادثات في الخلفية وينفّذ إجراءً للتفاعل مع عناصر UnityEngine:

// Google Mobile Ads events are raised off the Unity main thread.

// This log is executed off the Unity main thread.
// Write all time-sensitive code before ExecuteInUpdate().
Debug.Log("Executing off the Unity main thread.");

// Use ExecuteInUpdate to run code on the main thread, allowing you to
// interact with Unity UI and GameObjects.
// Changed to fully-qualified name to resolve CS0103
GoogleMobileAds.Common.MobileAdsEventExecutor.ExecuteInUpdate(() =>
{
    // This callback may be delayed on Android until the user returns to the app.
    Debug.Log("Executing on the Unity main thread.");

    // Place all code that interacts with Unity UI and GameObjects inside this callback.
    if (_myGameObject != null)
    {
        _myGameObject.SetActive(true);
    }
});
GlobalSettingsSnippets.cs

أتمتة المزامنة عند وقوع أحداث إعلانية

لمزامنة أحداث الإعلانات، اضبط السمة MobileAds.RaiseAdEventsOnUnityMainThread على true:

...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // When true all events raised by GoogleMobileAds will be raised
        // on the Unity main thread. The default value is false.
        MobileAds.RaiseAdEventsOnUnityMainThread = true;
    }
}

التحكّم في مستوى صوت إعلانات الفيديو

إذا كان تطبيقك يتضمّن عناصر تحكّم خاصة به في مستوى الصوت، مثل مستويات مخصّصة للموسيقى أو المؤثرات الصوتية، فإنّ الإفصاح عن مستوى الصوت في التطبيق يتيح لإعلانات الفيديو مراعاة إعدادات مستوى الصوت في التطبيق. ويضمن ذلك عرض إعلانات الفيديو للمستخدمين بمستوى الصوت المتوقّع.

يحدّد مستوى صوت الجهاز، الذي يتم التحكّم فيه من خلال أزرار مستوى الصوت أو شريط تمرير مستوى الصوت على مستوى نظام التشغيل، مستوى صوت إخراج الصوت من الجهاز. ومع ذلك، يمكن للتطبيقات ضبط مستويات الصوت بشكل مستقل بما يتناسب مع مستوى صوت الجهاز لتخصيص تجربة الصوت.

يمكنك إرسال تقرير عن مستوى صوت التطبيق النسبي إلى من خلال استدعاء الطريقة 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، أي مستوى صوت الجهاز الحالي، ولا يكون التطبيق مكتومًا.

الموافقة على ملفات تعريف الارتباط

إذا كان تطبيقك يتضمّن متطلبات خاصة، يمكنك ضبط المفتاح الاختياري ApplicationPreferences gad_has_consent_for_cookies على صفر لتفعيل الإعلانات المحدودة :

// Enable limited ads
ApplicationPreferences.SetInt("gad_has_consent_for_cookies", 0);

تصغير حجم تطبيق Android

يتيح لك خيار النشر في Unity تفعيل تصغير حجم رمز Java. في حال تفعيل التصغير، عليك أيضًا إنشاء ملف Proguard مخصّص للاحتفاظ بالفئات التي تشير إليها حزمة SDK.

1. تفعيل ملف Proguard المخصّص

   انتقِل إلى إعدادات المشروع > المشغّل > Android > إعدادات النشر > الإنشاء، واختَر:

   • ملف Proguard مخصّص

2. افتح /Assets/Plugins/Android/proguard-user.txt وأضِف ما يلي:

-keep class com.google.** { public *; }

إيقاف ميزة إعداد تقارير الأعطال

تجمع تقارير الأعطال لأغراض تصحيح الأخطاء والتحليل. لإيقاف ميزة "إعداد تقارير الأعطال"، راجِع الأقسام التالية الخاصة بنظامَي التشغيل Android وiOS.

<manifest>
   <application>
       <meta-data
           android:name="com.google.android.gms.ads.flag.DISABLE_CRASH_REPORTING"
           android:value="true" />
   </application>
</manifest>

void Awake() {
  MobileAds.DisableSDKCrashReporting();
}

الحصول على إصدار المكوّن الإضافي لمحرّك الألعاب Unity

للحصول على إصدار حزمة تطوير البرامج (SDK) في Unity، نفِّذ ما يلي:

// Get the Unity SDK version.
Debug.Log("Unity SDK Version: " + MobileAds.GetVersion());

الحصول على إصدار النظام الأساسي

تعتمد في Unity على حِزم تطوير البرامج (SDK) لنظامَي التشغيل Android وiOS. للحصول على إصدار حزمة تطوير البرامج (SDK) للنظام الأساسي، نفِّذ ما يلي:

// Get the underlying platform SDK version.
Debug.Log("Platform SDK Version: " + MobileAds.GetPlatformVersion());