Plugin

NativeUtils

Thông tin app/thiết bị và các thao tác native nhỏ mà Godot chưa có sẵn: chia sẻ, đánh giá app, Advertising ID, Install Referrer.

Gồm thư viện Android. Thư viện iOS chưa có trong gói (cần build trên Mac) — trên iOS các hàm trả giá trị mặc định. Giải nén vào thư mục gốc project Godot.

Cài đặt

Làm theo Cài đặt nhanh với addon leono_nativeutils. Plugin không cần key hay file cấu hình nào.

Bắt đầu

var app := NativeUtils.get_app_info()
# {id, version_name, version_code, installer}
var dev := NativeUtils.get_device_info()
# {brand, manufacturer, model, os_version, sdk_int, is_emulator, total_ram_mb}

NativeUtils.set_clipboard("ABC-123")
NativeUtils.share_text("Chơi cùng mình nhé! https://...", "Mời bạn")

# Hàm bất đồng bộ — dùng await
var ref := await NativeUtils.get_install_referrer()
if ref.has("params"):
    print(ref.params.get("utm_source", ""))

await NativeUtils.request_review()

Cấu hình

Trong Project Settings → leono/nativeutils (bật Advanced Settings). Mặc định đều tắt.

API reference

Thông tin app & thiết bị

if NativeUtils.get_network_type() == "cellular":
    show_download_warning()

Hành động

NativeUtils.share_text("Mình vừa đạt 1000 điểm! https://leono.game/x", "Thử thách")

NativeUtils.open_store_page("6470000000")

Bất đồng bộ

Các hàm dưới đây dùng với await. Nếu không muốn await, kết nối signal tương ứng của autoload.

func _on_level_10_cleared() -> void:
    await NativeUtils.request_review()
    resume_game()

var ad := await NativeUtils.get_advertising_id()
if not ad.limited:
    analytics.set_ad_id(ad.id)

Hướng dẫn: Advertising ID

GAID/IDFA kéo theo permission AD_ID trên Android và popup App Tracking Transparency trên iOS. Đây là vùng dễ bị store từ chối — đặc biệt với game cho trẻ em (Google Families policy, Apple Kids category) — nên tính năng tắt mặc định.

1. Bật settingProject Settings → leono/nativeutils/advertising_id = true.
2. Viết câu giải thích cho iOSios_tracking_usage_description, ví dụ "Dữ liệu được dùng để hiển thị quảng cáo phù hợp hơn với bạn." Thiếu câu này iOS luôn trả rỗng.
3. Gọi đúng lúcTrên iOS lần gọi đầu hiện popup ATT. Gọi sau khi người chơi đã vào game (ví dụ sau tutorial), không gọi ngay lúc app vừa mở.
4. Khai báo trên storePlay Console → Data safety: khai báo Advertising ID. App Store Connect → App Privacy: khai báo dữ liệu dùng để tracking.

Hướng dẫn: Install Referrer

Dùng để biết người chơi đến từ chiến dịch nào. Gắn tham số referrer (đã URL-encode) vào link Play Store:

https://play.google.com/store/apps/details?id=com.leono.game&referrer=utm_source%3Dfacebook%26utm_campaign%3Dsummer

const SAVE_KEY := "install_source"

func _ready() -> void:
    if Save.has(SAVE_KEY):
        return
    var ref := await NativeUtils.get_install_referrer()
    Save.set_value(SAVE_KEY, ref.get("params", {}).get("utm_source", "organic"))

Khác biệt giữa nền tảng

Lịch sử phiên bản