Cài đặt chung

Lớp MobileAds cung cấp các chế độ cài đặt chung cho .

Tạo sự kiện quảng cáo trên luồng chính của Unity

tạo sự kiện trên một luồng khác với luồng chính của Unity. Nếu triển khai các sự kiện quảng cáo và tương tác với các đối tượng Unity, bạn cần đồng bộ hoá các sự kiện với luồng chính của Unity.

Đồng bộ hoá các sự kiện quảng cáo với luồng chính của Unity theo cách thủ công hoặc tự động bằng cách cho phép xử lý quá trình đồng bộ hoá.

Đề xuất: Đồng bộ hoá sự kiện quảng cáo theo cách thủ công

Để đồng bộ hoá các sự kiện quảng cáo theo cách thủ công, hãy sử dụng phương thức ExecuteInUpdate trên luồng chính. Bạn nên sử dụng phương thức ExecuteInUpdate khi tương tác với các đối tượng UnityEngine và trong khi thuộc tính RaiseAdEventsOnUnityMainThread bị vô hiệu hoá.

Ví dụ sau đây ghi lại một luồng trong nền và chạy một thao tác để tương tác với các đối tượng 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

Tự động hoá việc đồng bộ hoá các sự kiện quảng cáo

Để đồng bộ hoá các sự kiện quảng cáo, hãy đặt thuộc tính MobileAds.RaiseAdEventsOnUnityMainThread thành 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;
    }
}

Kiểm soát âm lượng của quảng cáo dạng video

Nếu ứng dụng của bạn có các chế độ kiểm soát âm lượng riêng (chẳng hạn như mức âm lượng của hiệu ứng âm thanh hoặc âm nhạc tuỳ chỉnh), thì việc cho biết mức âm lượng của ứng dụng sẽ cho phép quảng cáo dạng video tuân thủ các chế độ cài đặt âm lượng của ứng dụng. Việc này đảm bảo người dùng nhận được quảng cáo dạng video có âm lượng mong muốn.

Âm lượng của thiết bị (mà bạn có thể kiểm soát thông qua các nút âm lượng hoặc thanh trượt âm lượng ở cấp hệ điều hành) sẽ xác định âm lượng cho đầu ra âm thanh của thiết bị. Tuy nhiên, các ứng dụng có thể tự điều chỉnh mức âm lượng tương ứng với mức âm lượng của thiết bị để điều chỉnh trải nghiệm âm thanh.

Bạn có thể báo cáo âm lượng tương ứng của ứng dụng cho bằng cách gọi phương thức SetApplicationVolume() trước khi tải quảng cáo. Các giá trị âm lượng hợp lệ của quảng cáo nằm trong khoảng từ 0.0 (im lặng) đến 1.0 (âm lượng hiện tại của thiết bị). Dưới đây là một ví dụ về cách báo cáo âm lượng tương ứng của ứng dụng cho SDK:

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

Để thông báo cho SDK biết rằng bạn đã tắt tiếng ứng dụng, hãy gọi phương thức SetApplicationMuted() trước khi tải quảng cáo: