การตั้งค่าส่วนกลาง

เลือกแพลตฟอร์ม: Android iOS Unity Android (เดิม)

คลาส MobileAds มีการตั้งค่าส่วนกลางสำหรับ Google Mobile Ads Unity Plugin

เรียกใช้เหตุการณ์โฆษณาในเทรดหลักของ Unity

Google Mobile Ads Unity Plugin จะเพิ่มเหตุการณ์ในเธรดอื่นที่ไม่ใช่เธรดหลักของ Unity หากใช้เหตุการณ์โฆษณาและโต้ตอบกับออบเจ็กต์ Unity คุณจะต้องซิงค์Google Mobile Ads Unity Pluginเหตุการณ์กับเทรดหลักของ Unity

ซิงโครไนซ์เหตุการณ์โฆษณากับเทรดหลักของ Unity ด้วยตนเองหรือ โดยอัตโนมัติโดยให้ Google Mobile Ads Unity Plugin จัดการการซิงโครไนซ์

แนะนำ: ซิงค์เหตุการณ์โฆษณาด้วยตนเอง

หากต้องการซิงค์เหตุการณ์โฆษณาด้วยตนเอง ให้ใช้เมธอด 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);
    }
});

ซิงค์เหตุการณ์โฆษณาโดยอัตโนมัติ

หากต้องการGoogle Mobile Ads Unity Pluginซิงโครไนซ์เหตุการณ์โฆษณา ให้ตั้งค่าพร็อพเพอร์ตี้ 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;
    }
}

การควบคุมระดับเสียงของโฆษณาวิดีโอ

หากแอปของคุณมีการควบคุมระดับเสียงในตัว เช่น ระดับเสียงเพลงหรือเอฟเฟ็กต์เสียงที่กำหนดเอง การเปิดเผยระดับเสียงของแอปต่อ Google Mobile Ads Unity Plugin จะช่วยให้โฆษณาวิดีโอ เล่นตามระดับเสียงที่ตั้งค่าไว้ในแอป ซึ่งจะช่วยให้ผู้ใช้ได้ยินเสียงโฆษณาวิดีโออย่างที่ควรจะเป็น

ระดับเสียงของอุปกรณ์ ซึ่งควบคุมผ่านปุ่มปรับระดับเสียงหรือแถบเลื่อนปรับระดับเสียงในระดับระบบปฏิบัติการ จะกำหนดระดับเสียงสำหรับเอาต์พุตเสียงของอุปกรณ์ อย่างไรก็ตาม แอปสามารถปรับระดับเสียงแยกกัน โดยอิงตามระดับเสียงของอุปกรณ์เพื่อปรับแต่งประสบการณ์ ด้านเสียง

คุณสามารถรายงานระดับเสียงของแอปที่เกี่ยวข้องไปยัง Google Mobile Ads Unity Plugin ได้โดยเรียกใช้เมธอด 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 ที่ไม่บังคับเป็น 0 เพื่อเปิดใช้โฆษณาแบบจำกัด ได้โดยทำดังนี้

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

การลดขนาด Android

ตัวเลือกการเผยแพร่ Unity นี้ช่วยให้คุณเปิดใช้การลดขนาดโค้ด Java ได้ หากเปิดใช้การลดขนาด คุณจะต้องสร้างไฟล์ Proguard ที่กำหนดเอง เพื่อเก็บคลาสที่ SDK อ้างอิงไว้ด้วย

  1. เปิดใช้ไฟล์ Proguard ที่กำหนดเอง

    ไปที่ การตั้งค่าโปรเจ็กต์ > Player > Android > การตั้งค่าการเผยแพร่ > สร้าง แล้วเลือก

    • ไฟล์ Proguard ที่กำหนดเอง

  2. เปิด /Assets/Plugins/Android/proguard-user.txt แล้วเพิ่มข้อมูลต่อไปนี้

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

ปิดใช้การรายงานข้อขัดข้อง

Google Mobile Ads Unity Plugin รวบรวมรายงานข้อขัดข้องเพื่อวัตถุประสงค์ในการแก้ไขข้อบกพร่องและการวิเคราะห์ หากต้องการปิดใช้การรายงานข้อขัดข้อง โปรดดูส่วนต่อไปนี้สำหรับ Android และ iOS

Android

เพิ่มแท็ก <meta-data> โดยตั้งค่า DISABLE_CRASH_REPORTING เป็น true ใน ไฟล์ AndroidManifest.xml ของแอป

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

iOS

เรียกใช้เมธอด DisableSDKCrashReporting เพื่อปิดใช้รายงานข้อขัดข้องใน iOS

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

รับเวอร์ชันปลั๊กอิน Unity

หากต้องการดูเวอร์ชัน Unity SDK ให้เรียกใช้คำสั่งต่อไปนี้

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

รับเวอร์ชันของแพลตฟอร์ม

Google Mobile Ads Unity Plugin สำหรับ Unity ขึ้นอยู่กับ SDK ของแพลตฟอร์ม Android และ iOS หากต้องการดูเวอร์ชันของ SDK แพลตฟอร์ม ให้เรียกใช้คำสั่งต่อไปนี้

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