Pengguna dan ID pengguna terarah

*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.

Roblox mengekspos satu ID pengguna efektif untuk setiap pengguna di setiap game, grup, atau aplikasi. Tergantung pada riwayat pengguna dengan domain tersebut, ID pengguna efektif mereka adalah ID pengguna global mereka atau ID pengguna terarah. Halaman ini menjelaskan bagaimana ID pengguna efektif bekerja dan bagaimana menggunakan tipe User dalam kode game Anda.

Konsep-konsep berikut adalah inti dari identifikasi pengguna:

KonsepDeskripsi
PenggunaAkun yang persisten di Roblox.
PemainRepresentasi pengguna dalam model data game yang sedang berjalan (lihat Pemain).
tipe data UserJenis data yang membawa ID pengguna efektif dan konteks domainnya. Ini adalah pengidentifikasi standar untuk merujuk pengguna dalam kode game.
ID pengguna globalID pengguna tingkat platform yang diberikan Roblox untuk setiap akun. Ini unik secara global di seluruh Roblox.
ID pengguna terarahID pengguna yang diberikan dalam domain tertentu. ID pengguna terarah seorang pengguna berbeda di setiap game, grup, atau aplikasi.
ID pengguna efektifID pengguna tunggal yang diekspos Roblox untuk pengguna dalam sebuah domain.
Pengguna pra-luncuranPengguna yang pertama kali terlibat dengan domain sebelum peluncuran ID pengguna terarah. Dalam domain tersebut, ID pengguna efektif mereka tetap menjadi ID pengguna global mereka.
Pengguna pasca-luncuranPengguna yang pertama kali terlibat dengan domain setelah peluncuran ID pengguna terarah. Dalam domain tersebut, ID pengguna efektif mereka adalah ID pengguna terarah.

ID pengguna efektif dan domain

Setiap pengguna memiliki satu ID pengguna efektif dalam game, grup, atau aplikasi tertentu. Roblox tidak mengekspos ID pengguna global dan terarah yang terpisah untuk pengguna yang sama dalam domain tersebut:

  • Seorang pengguna pra-luncuran memiliki ID pengguna global mereka sebagai ID pengguna efektif mereka.
  • Seorang pengguna pasca-luncuran memiliki ID pengguna terarah sebagai ID pengguna efektif mereka. ID tersebut hanya berarti dalam domain tersebut.

Dalam kode game, Player.UserId dan Player.User.Id keduanya mengembalikan ID pengguna efektif ini dan selalu memiliki nilai numerik yang sama (Player.User.Id sama dengan Player.UserId), sehingga kode Anda tidak perlu logika percabangan untuk memilih di antara keduanya.

Roblox membatasi identitas pengguna di tiga jenis domain:

DomainTerarah keContoh
Pengalaman (Enum.DomainType.EXPERIENCE)Sebuah pengalaman tertentuID pemain di pengalaman Anda
GrupSebuah grup Roblox tertentu (komunitas)ID anggota di grup Anda
Aplikasi OAuth (Enum.DomainType.OAUTH)Sebuah aplikasi OAuth tertentuID pengguna di alat eksternal Anda

Cara kerja ID pengguna efektif

Ketika seorang pemain bergabung dengan game Anda, mereka memiliki satu ID pengguna efektif untuk game tersebut. ID pengguna efektif seorang pengguna pasca-luncuran adalah ID pengguna terarah yang unik untuk game tersebut. Mereka menerima ID pengguna terarah yang berbeda di game, grup, atau aplikasi lain di mana mereka juga merupakan pengguna pasca-luncuran. Ini berarti:

  • ID pengguna efektif adalah bilangan bulat, baik itu global atau terarah.
  • ID pengguna efektif stabil di seluruh sesi dalam domain yang sama.
  • ID pengguna terarah tidak bertabrakan dengan ID pengguna global yang ada.
  • Nilai numerik yang sama dapat muncul di domain yang berbeda untuk pengguna yang berbeda. Kunci unik adalah kombinasi dari domain (tipe domain dan ID domain) dan ID pengguna efektif.

Contoh skenario

Contoh berikut menunjukkan bagaimana game yang berbeda merujuk pengguna yang sama:

SkenarioKonteks penggunaID pengguna efektif yang dilihat oleh game
Pengguna terhubung ke Game APengguna pra-luncuran123 (ID pengguna global, tidak berubah)
Pengguna terhubung ke Game BPengguna pasca-luncuran500789 (ID pengguna terarah untuk Game B)
Pengguna terhubung ke Game CPengguna pasca-luncuran302441 (ID pengguna terarah untuk Game C)

Pengguna pra-luncuran

Jika seorang pemain adalah pengguna pra-luncuran di game Anda, ID pengguna efektif mereka tetap menjadi ID pengguna global mereka dalam game tersebut. Baik Player.UserId dan Player.User.Id mengembalikan ID pengguna global tersebut. Roblox tidak mengekspos ID pengguna kedua untuk pemain dalam game tersebut. Ini memastikan kunci penyimpanan data yang ada, papan peringkat, dan inventaris terus berfungsi tanpa perubahan.

Domain grup

Setiap grup Roblox adalah domainnya sendiri. Seorang pengguna memiliki satu ID pengguna efektif dalam grup, terpisah dari ID pengguna efektif mereka di game atau aplikasi OAuth mana pun:

Bekerja dengan Tipe Pengguna

User adalah cara standar untuk mengidentifikasi pengguna dalam kode game. Nilai User membawa ID pengguna efektif bersama dengan tipe domain dan ID domain, sehingga konteks identitas selalu dibawa bersama pengidentifikasi. Untuk detail API lengkap, lihat referensi User.

Mendapatkan Pengguna dari Pemain

Cara utama untuk mendapatkan User adalah dari Player yang terhubung melalui Player.User:

local Players = game:GetService("Players")
Players.PlayerAdded:Connect(function(player)
local user = player.User
print("ID pengguna efektif:", user.Id) -- Selalu cocok dengan player.UserId
print("Tipe domain:", user.DomainType)
print("ID domain:", user.DomainId)
end)

Membuat Pengguna dari ID

Untuk membuat User dari ID pengguna efektif yang diketahui dalam game saat ini, gunakan User.fromId():

local user = User.fromId(knownUserId)

Menggunakan Pengguna dengan API engine

API engine yang menerima parameter ID pengguna juga menerima nilai User secara langsung. Menggunakan User sangat dianjurkan:

-- Kedua bentuk berfungsi:
BadgeService:AwardBadge(player.User, badgeId) -- Disarankan
BadgeService:AwardBadge(player.UserId, badgeId)
-- Kedua bentuk berfungsi:
local target = Players:GetPlayerByUserId(player.User) -- Disarankan
local target = Players:GetPlayerByUserId(someUserId)

Ketika ID pengguna numerik diteruskan ke API engine yang menerima ID pengguna, itu secara otomatis dibungkus menjadi User secara internal.

API engine yang mengembalikan ID pengguna

API engine yang mengembalikan ID pengguna numerik mengembalikan ID pengguna efektif pengguna:

  • Pengguna pra-luncuran — API mengembalikan ID pengguna global pengguna.
  • Pengguna pasca-luncuran — API mengembalikan ID pengguna terarah pengguna.

Player.UserId, Player.User.Id, dan API engine lainnya semua mengembalikan ID pengguna efektif yang sama untuk pengguna di game Anda, sehingga kode yang ada yang membaca bidang ID pengguna numerik terus berfungsi tanpa logika percabangan.

Permintaan dan respons Open Cloud menggunakan ID pengguna efektif yang sama untuk domain target. Mereka tidak mengekspos ID pengguna kedua untuk pengguna yang sama dalam domain tersebut.

Menyimpan identitas pengguna

Gunakan ID pengguna efektif numerik hanya untuk mengidentifikasi pengguna dalam satu domain. Kunci penyimpanan data dalam satu game dapat menggunakan user.Id secara langsung:

local key = ("player_%d"):format(player.User.Id)
PlayerDataStore:SetAsync(key, data)

Ketika domain lain membaca identitas yang disimpan, seperti aplikasi OAuth yang memoderasi pengguna, simpan string dari ToString(). String tersebut mengkode konteks domain bersama dengan ID pengguna efektif. Menggunakan integer saja dapat menerapkan tindakan pada pengguna yang salah ketika nomor yang sama mengidentifikasi pengguna yang berbeda di domain lain.

local encoded = player.User:ToString()
SomeDataStore:SetAsync("support_ticket_user", encoded)
-- Nanti, pulihkan dari string
local user = User.fromString(encoded)

Untuk detail lebih lanjut tentang jaminan serialisasi, lihat referensi User.

Praktik terbaik

  • Gunakan Player.User sebagai pengidentifikasi standar dalam kode baru.
  • Gunakan ID pengguna efektif numerik hanya dalam satu domain, seperti kunci penyimpanan data untuk satu game.
  • Gunakan ToString() dan fromString() ketika domain lain membaca identitas yang disimpan.

Kapan menggunakan Pengguna atau Pemain

  • Gunakan Player untuk tindakan dalam server: pergerakan karakter, GUI, teleportasi, obrolan, inventaris.
  • Gunakan User untuk identitas yang bertahan lebih lama dari sesi: penyimpanan data, alat Open Cloud, referensi lintas game.
©2026 Roblox Corporation. Roblox, logo Roblox, dan Powering Imagination termasuk dalam merek dagang kami yang terdaftar dan tidak terdaftar di AS dan negara lainnya.