InsertService digunakan untuk menyisipkan aset dari situs web Roblox, biasanya fungsi `Class.InsertService:LoadAsset()|LoadAsset`.

  Untuk memuat aset, itu harus diakses oleh pencipta pengalaman yang memuatnya, yang bisa menjadi pengguna atau grup.Haruskah pengalaman diunggah oleh kreatoryang berbeda, data aset tidak akan dapat diakses.Lihat metode `Class.InsertService:LoadAsset()|LoadAsset()` untuk lebih banyak rincian tentang periksakeamanan ini.Perhatikan bahwa Anda tidak boleh **tidak** menggunakan layanan ini untuk memuat kunci API atau rahasia lainnya.Gunakan `Class.HttpService:GetSecret()` sebagai gantinya.

  #### Lihat Juga

  *   `Class.AssetService` , yang dapat memberikan informasi tentang aset yang mungkin ingin Anda muat menggunakan Layanan Masuk

InsertService:ApproveAssetId

assetId

InsertService:ApproveAssetVersionId

assetVersionId

Fungsi ini adalah metode lama yang digunakan untuk menyisipkan `Class.Instance` ke `Class.Workspace` .

InsertService:Insert

instance

Memasukkan `Class.Instance` ke dalam `Class.Workspace` .

Membuat baru `Class.MeshPart` dengan spesifikasi `Class.MeshPart.CollisionFidelity|CollisionFidelity` dan `Class.MeshPart.RenderFidelity|RenderFidelity` .Karena `Class.MeshPart.MeshId` dibaca hanya, inilah cara untuk membuat `Class.MeshPart` melalui skrip tanpa harus menyalin yang sudah ada.Ia melempar kesalahan jika penciptaan gagal.

InsertService:CreateMeshPartAsync

meshId

collisionFidelity

Tetapkan `Class.MeshPart.CollisionFidelity`.

renderFidelity

Tetapkan `Class.MeshPart.RenderFidelity`.

Membuat baru `Class.MeshPart` dengan nilai kesetiaan yang ditentukan.

InsertService:GetBaseCategories

Kembalikan array kamus, yang berisi informasi tentang berbagai set yang disetujui Roblox.

InsertService:GetBaseSets

The format of the returned table is as follows:

<pre>
{ -- Array
{ -- Table
AssetId = &lt;Integer>, -- for use with InsertService::LoadAsset()
AssetSetId = &lt;Integer>, -- source set
AssetVersionId = &lt;Integer>, -- for use with
InsertService::LoadAssetVersion()
IsTrusted = &lt;Integer>, -- "trusted" flag
Name = &lt;String>, -- model name
CreatorName = &lt;String> -- creator name
}
}
</pre>

Kembalikan model yang paling baru diunggah dalam kategori yang ditentukan.

InsertService:GetCollection

categoryId

Fungsi GetFreeDecals memulihkan daftar gratis `Class.Decal|Decals` dari katalog.Jenis pengembalian untuk metode ini sangat aneh, karena mengembalikan satu tabel yang dibungkus dalam tabel.

  Cara terbaik untuk menjelaskannya adalah dengan menunjukkan visual array yang dikembalikan:

  ```lua
  [1] = {
  	CurrentStartIndex = 1, -- Ini bisa bervariasi tergantung pada halaman yang Anda masukkan.
  	TotalCount = 21, -- Selalu 21.
  	Results = {
  		-- Semua parameter di sini adalah palsu. Mereka dapat bervariasi tergantung pada aset.
  		[1] = {
  			Name = "Asset Name",
  			AssetId = 0000000,
  			AssetVersionId = 0000000,
  			CreatorName = "Roblox",
  		},
  		-- [2], [3], dan seterusnya... sampai [21]
  	},
  }
  ```

  Contoh untuk mengulangi atas daftar ini telah disediakan di bagian bawah halaman ini.

  Selain itu, jika Anda ingin menyisipkan `Class.Model|Models` sebagai gantinya, Anda dapat menggunakan fungsi `Class.InsertService:GetFreeModels()`.

  *Catatan:* Argumen halaman dimulai pada 0. Jadi Halaman 1 = 0, Halaman 2 = 1, dll.

InsertService:GetFreeDecals

searchText

String yang digunakan untuk mencari gambar gratis di katalog.

pageNum

Nomor halaman di Katalog untuk dikembalikan.

Satu meja (decal gratis yang dikembalikan) dibungkus dalam meja.

Mengambil daftar Stiker gratis dari katalog.

Fungsi GetFreeModels memulihkan daftar Gratis `Class.Model|Models` dari katalog.Jenis pengembalian untuk metode ini sangat aneh, karena mengembalikan satu tabel yang dibungkus dalam tabel.

  Cara terbaik untuk menjelaskannya adalah dengan menunjukkan visual array yang dikembalikan:

  ```lua
  [1] = {
  	CurrentStartIndex = 1, -- Ini bisa bervariasi tergantung pada halaman yang Anda masukkan.
  	TotalCount = 21, -- Selalu 21.
  	Results = {
  		-- Semua parameter di sini adalah palsu. Mereka dapat bervariasi tergantung pada aset.
  		[1] = {
  			Name = "Asset Name",
  			AssetId = 0000000,
  			AssetVersionId = 0000000,
  			CreatorName = "Roblox",
      		}
      		-- [2], [3], dan seterusnya... sampai [21]
      	}
  }
  ```

  Contoh untuk mengulangi atas daftar ini telah disediakan di bagian bawah halaman ini.

  Selain itu, jika Anda ingin menyisipkan gratis `Class.Decal|Decals` , Anda dapat menggunakan fungsi `Class.InsertService:GetFreeDecals()`.

InsertService:GetFreeModels

Satu meja (model gratis yang dikembalikan) dibungkus dalam meja.

Mengambil daftar Model Gratis dari katalog.

Kembalikan AssetVersionId terbaru dari aset untuk aset yang dibuat oleh kreatortempat.Dapat digunakan bersama dengan `Class.InsertService:LoadAssetVersion()` untuk memuat versi terbaru model, bahkan jika diperbarui saat permainan berjalan.

InsertService:GetLatestAssetVersionAsync

InsertService:GetUserCategories

userId

Kembalikan array kamus, yang berisi informasi tentang set yang dimiliki oleh pengguna. Ini termasuk

  *   Tetapkan pengguna yang berlangganan.
  *   Set yang dibuat oleh pengguna.
  *   Satu set tunggal yang berisi model yang dibuat oleh pengguna.
  *   Satu set tunggal yang berisi stiker yang dibuat oleh pengguna.

  Catatan:

  *   Semua nilai dalam kamus adalah <a href="/luau/strings">string</a>, bahkan jika mereka adalah angka.

  <table>
    <thead>
      <tr>
        <th>Nama</th>

        <th>Deskripsi</th>
      </tr>
    </thead>

    <tbody>
      <tr>
        <td>Nama</td>

        <td>Nama atur.</td>
      </tr>

      <tr>
        <td>Deskripsi</td>

        <td>Deskripsi atur.</td>
      </tr>

      <tr>
        <td>ID Aset Gambar</td>

        <td>AssetId untuk ikon dari atur.</td>
      </tr>

      <tr>
        <td>Nama Pencipta</td>

        <td>Pencipta dari atur.</td>
      </tr>

      <tr>
        <td>Setidaknya ID Aset</td>

        <td>ID unik aturpada situs web.</td>
      </tr>

      <tr>
        <td>KategoriId</td>

        <td>Sama dengan AssetSetId</td>
      </tr>

      <tr>
        <td>Tetapkan Jenis</td>

        <td>Jenis set yang set ini.</td>
      </tr>
    </tbody>
  </table>

InsertService:GetUserSets

Kembalikan array kamus, yang berisi informasi tentang set yang dimiliki oleh pengguna.

Fungsi LoadAsset mengambil aset dengan IDnya dan kembalikan aset `Class.Model` yang berisi aset.Sebagai contoh, untuk memuat ini publik [Doge](https://www.roblox.com/library/257489726/Doge)`Class.Model` , yang memiliki ID aset ***257489726** * , Anda dapat menggunakan:

  ```lua
  local InsertService = game:GetService("InsertService")
  local Workspace = game:GetService("Workspace")

  local assetId = 257489726
  local model = InsertService:LoadAsset(assetId)
  model.Parent = Workspace
  ```

  Panggilan ke fungsi ini mungkin gagal jika server yang menyediakan model mengalami masalah.Dengan demikian, umumnya merupakan ide bagus untuk melapisi panggilan ke fungsi ini di `pcall` untuk menangkap jenis kesalahan ini.

  ```lua
  local InsertService = game:GetService("InsertService")
  local Workspace = game:GetService("Workspace")

  local assetId = 257489726

  local success, model = pcall(InsertService.LoadAsset, InsertService, assetId)
  if success and model then
  	print("Model loaded successfully")
  	model.Parent = Workspace
  else
  	print("Model failed to load!")
  end
  ```

  #### Pemeriksaan Keamanan

  Aset yang dimuat oleh fungsi ini harus **diciptakan atau dimiliki** oleh pembuat game atau Roblox.Selain itu, jenis aset yang tidak berbahaya seperti kaus, kemeja, celana, dan aksesori avatar dapat dimuat dari game apa pun karena mereka publik.

  Lihat juga:

  *   `Class.AssetService:GetBundleDetailsAsync()` , untuk mengetahui aset mana yang terkait dengan bundel.
  *   Untuk plugin, lihat `Class.DataModel:GetObjects()`

InsertService:LoadAsset

Kembalikan `Class.Model` yang berisi aset.

Kembalikan model yang dimasukkan ke `Class.InsertService` berisi aset dengan asetVersionId yang diberikan.

InsertService:LoadAssetVersion

InsertService:loadAsset

InsertService

InsertService.AllowClientInsertModels

Properti AllowInsertFreeModels menyala/mati apakah "Model Gratis" dapat dimasukkan ke dalam game, terlepas dari apakah pemilik tempat memiliki aset.

InsertService.AllowInsertFreeModels

Menunjukkan apakah "Model Gratis" dapat dimasukkan ke dalam game.

Digunakan untuk menyisipkan aset dari situs web Roblox.

`Instance` adalah kelas dasar untuk semua kelas dalam hierarki kelas Roblox yang dapat menjadi bagian dari pohon `Class.DataModel`.

  Tidak mungkin untuk langsung membuat objek akar `Instance` , tetapi konstruktor khusus `Datatype.Instance.new()` membuat objek melalui kode, mengambil nama kelas sebagai parameter dan mengembalikan objek yang dibuat.

Demonstrates detecting changes to an instance's ancestry by connecting to the `Class.Instance.AncestryChanged` event.

The ChangingPart's Parent is set to different values overtime. The parent of the part is the part's ancestor, so the `Class.Instance.AncestryChanged` event will fire whenever it changes.

Memicu ketika properti `Class.Instance.Parent` dari objek atau salah satu leluhurnya diubah.

  Acara ini mencakup dua parameter: merujuk pada yang sebenarnya telah diubah, sementara merujuk pada baru kasus ini.

  Anda dapat menggunakan acara ini untuk melacak penghapusan instansi di Studio, seperti penghapusan manual di Explorer atau melalui plugin.Jika Anda perlu mendeteksi kapan instansi dihancurkan menggunakan `Class.Instance:Destroy()` , gunakan acara `Class.Instance.Destroying` sebagai gantinya.

Instance.AncestryChanged

child

The `Class.Instance` yang `Class.Instance.Parent` telah diubah.

parent

The new `Class.Instance.Parent` dari `Class.Instance` yang `Class.Instance.Parent` telah diubah.

Memicu ketika properti `Class.Instance.Parent` dari objek atau salah satu leluhurnya diubah.

Peristiwa ini terjadi setiap kali ada atribut yang diubah pada instans, termasuk saat atribut diatur ke `nil` .Nama atribut yang diubah dikirim ke fungsi terhubung.

  Sebagai contoh, potongan kode berikut menghubungkan fungsi `attributeChanged()` ke api setiap kali salah satu atribut bagian berubah:

  ```lua
  local Workspace = game:GetService("Workspace")

  local part = Workspace.Part

  local function attributeChanged(attributeName)
  	print(attributeName, "changed")
  end

  part.AttributeChanged:Connect(attributeChanged)
  ```

  Lihat juga `Class.Instance:GetAttributeChangedSignal()` yang men返ikan peristiwa yang menyala saat atribut tertentu berubah.

Instance.AttributeChanged

attribute

Memicu kebakaran setiap kali atribut diubah pada `Class.Instance`.

This snippet prints the names of objects as they are added to the Workspace:

Api setelah objek diberikan kepada orangtua ini `Class.Instance` .

  Catatan, saat menggunakan fungsi ini pada klien untuk mendeteksi objek yang dibuat oleh server, diperlukan untuk menggunakan `Class.Instance:WaitForChild()` saat mengindeks keturunan objek ini.Ini karena objek dan keturunannnya tidak dijamin untuk mereplikasi dari server ke klien secara bersamaan.Sebagai contoh:

  ```
  local Workspace = game:GetService("Workspace")

  Workspace.ChildAdded:Connect(function(child)
  	-- Use WaitForChild() since descendants may not have replicated yet
  	local head = child:WaitForChild("Head")
  end)
  ```

  Catatan, fungsi ini hanya berfungsi untuk anak-anak langsung dari `Class.Instance` . Untuk fungsi yang menangkap semua keturunan, gunakan `Class.Instance.DescendantAdded` .

  Lihat juga `Class.Instance.ChildRemoved` .

Instance.ChildAdded

The `Class.Instance` yang telah ditambahkan.

Api setelah objek diberikan kepada orangtua ini `Class.Instance` .

This snippet prints the names of objects as they are removed from the
Workspace:

Api setelah anak dihapus dari ini `Class.Instance` .

  Dihapus merujuk pada ketika orangtua objek diubah dari ini `Class.Instance` ke sesuatu yang berbeda dari ini `Class.Instance` .Catatan, acara ini juga akan terjadi saat anak dihancurkan (menggunakan `Class.Instance:Destroy()` ) karena fungsi hancur menetapkan orangtua objek menjadi `nil` .

  Fungsi ini hanya berfungsi untuk anak-anak langsung dari `Class.Instance` . Untuk fungsi yang menangkap semua keturunan, gunakan `Class.Instance.DescendantRemoving` .

  Lihat juga `Class.Instance.ChildAdded` .

Instance.ChildRemoved

Api setelah anak dihapus dari ini `Class.Instance` .

This following example will print the name of any object that is added to the
Workspace:

Peristiwa ini terjadi setelah keturunan ditambahkan ke `Class.Instance`.

  Saat menembak untuk setiap keturunan, membesarkan objek ke `Class.Instance` akan menembakkan peristiwa untuk objek ini dan semua keturunannnya secara individual.

  Jika Anda hanya peduli dengan anak-anak langsung dari , gunakan sebagai gantinya.

  Lihat juga `Class.Instance.DescendantRemoving` .

Instance.DescendantAdded

descendant

Api setelah keturunan ditambahkan ke `Class.Instance` .

The following example prints the name of any descendant as it is being removed
from the Workspace:

Peristiwa ini menembak **segera sebelum** orangtua `Class.Instance` mengubah sehingga instansi **turunan** tidak lagi menjadi turunan.`Class.Instance:Destroy()|Destroy()` mengubah `Class.Instance.Parent|Parent` instansi menjadi `nil` , sehingga memanggil metode itu pada turunan dari orangtua akan menyebabkan peristiwa ini terjadi.

  Karena acara ini menembak **sebelum** penghapusan keturunan, orangtua keturunan tidak akan berubah saat penembakan acara ini.Jika keturunan juga merupakan anak langsung **dari orang tua** , acara ini akan terbakar sebelum `Class.Instance.ChildRemoved`.

  Jika seorang keturunan memiliki anak, acara ini terbakar dengan keturunan terlebih dahulu, diikuti oleh anak-anaknya.

  ##### Peringatan

  Peristiwa ini terjadi dengan objek keturunan yang dihapus.Mencoba untuk mengatur `Class.Instance.Parent|Parent` anak turun ke sesuatu yang lain akan gagal.Di bawah ini adalah contoh yang menunjukkan ini:

  ```
  local Workspace = game:GetService("Workspace")

  Workspace.DescendantRemoving:Connect(function(descendant)
  	-- Do not manipulate the parent of the descendant in this function!
  	-- This event fires BECAUSE the parent was manipulated, and the change hasn't happened yet
  	-- Therefore, it is problematic to change the parent like this:
  	descendant.Parent = game
  end)

  local part = Instance.new("Part")
  part.Parent = Workspace
  part.Parent = nil
  ```

  Lihat juga `Class.Instance.DescendantAdded|DescendantAdded` .

Instance.DescendantRemoving

Api segera sebelum keturunan dari `Class.Instance` dihapuskan.

This sample demonstrates how, when using Immediate signal behavior, an Instance being destroyed remains in place until the connected function yields.

This sample demonstrates how, when using Deferred signal behavior,
an Instance is destroyed before the signal fires.

The `Class.Instance` tidak akan pernah dihapus dari memori saat fungsi terhubung masih menggunakannya.Namun, jika fungsi menghasilkan di titik mana pun, `Class.Instance` dan keturunannnya akan diberikan kepada `nil` .

  Jika properti `Class.Workspace.SignalBehavior` diatur ke `Enum.SignalBehavior.Immediate` , acara ini terbakar segera sebelum `Class.Instance` atau salah satu leluhurnya hancur dengan `Class.Instance:Destroy()` .

  Jika properti `Class.Workspace.SignalBehavior` diatur ke `Enum.SignalBehavior.Deferred` , acara ini akan terjadi di titik penyambungan berikutnya, yang akan terjadi setelah `Class.Instance` atau salah satu leluhurnya hancur dengan `Class.Instance:Destroy()` .

  Dengan perilaku `Enum.SignalBehavior.Deferred|Deferred` , menghubungkan skrip ke acara sendiri `Class.Instance.Destroying` adalah bermasalah, karena skrip akan dihapus sebelum panggilan balasan dapat dilakukan (berarti tidak akan dieksekusi).

  Saat menghapus `Class.Instance` di Studio, seperti menghapus secara manual melalui [Explorer](/studio/explorer) atau melalui plugin, `Class.Instance` tidak hancur.Sebagai gantinya, orangtua diatur ke `nil` yang dapat Anda pelacak dengan `Class.Instance.AncestryChanged` .

Instance.Destroying

Api segera sebelum (atau ditunda sampai setelah) instansi dihancurkan melalui `Class.Instance:Destroy()` .

Acara ini terjadi setiap kali properti gaya diubah pada instance, termasuk saat properti diatur ke `nil` .

  ```lua
  local Players = game:GetService("Players")

  local player = Players.LocalPlayer
  local playerGui = player.PlayerGui
  local HUDContainer = playerGui:WaitForChild("HUDContainer")
  local meterBar = HUDContainer.MeterBar

  local function stylePropertyChanged()
  	print("Styled properties changed")
  end

  meterBar:StyledPropertiesChanged():Connect(stylePropertyChanged)
  ```

Instance.StyledPropertiesChanged

Memicu kapan pun properti gaya diubah pada instans, termasuk saat properti diatur ke `nil` .

Instance.childAdded

Metode ini menerapkan tag ke instansi, tanpa efek jika tag sudah diterapkan.Berhasil menambahkan tag akan menyala sinyal yang dibuat oleh `Class.CollectionService:GetInstanceAddedSignal()` dengan tag yang diberikan.

  ##### Peringatan

  *   Tag instansi yang ditambahkan sisi klien akan dihapus jika server kemudian menambahkan atau menghapus tag pada instansi itu karena server menyalin semua tag bersama-sama dan menghapus tag sebelumnya.

  *   Saat menandai instansi, umumnya beberapa sumber daya digunakan untuk memberikan tag fungsionalnya, misalnya koneksi acara atau tabel.Untuk mencegah kebocoran memori, ide bagus adalah membersihkan ini (putus koneksi, atur ke `nil` , dll.) ketika tidak lagi dibutuhkan untuk tag.Lakukan ini saat menelepon `Class.Instance:RemoveTag()` , menelepon `Class.Instance:Destroy()` , atau dalam fungsi yang terhubung ke sinyal yang dikembalikan oleh `Class.CollectionService:GetInstanceRemovedSignal()` .

Instance:AddTag

Fungsi ini menghancurkan semua anak dan keturunan instansi.

  ```
  local part = Instance.new("Part")

  -- Add some sparkles
  for i = 1, 3 do
  	local sparkles = Instance.new("Sparkles")
  	sparkles.Parent = part

    local sc = Instance.new("Sparkles")
    sc.Parent = sparkles
  end

  print("Children:", #part:GetChildren())  --> Children: 3

  part:ClearAllChildren()

  print("Children:", #part:GetChildren())  --> Children: 0
  ```

  Jika Anda tidak ingin menghancurkan **semua** anak-anak dan keturunan, gunakan `Class.Instance:GetChildren()` atau `Class.Instance:GetDescendants()` untuk melingkar melalui anak-anak / keturunan itu dan pilih apa yang harus dihancurkan.Sebagai contoh, sampel kode berikut akan menghancurkan semua `Class.BasePart|BaseParts` turun dari sebuah `Class.Model` :

  ```
  local Workspace = game:GetService("Workspace")

  local model = Workspace:FindFirstChild("TestModel")

  for _, descendant in model:GetDescendants() do
  	if descendant:IsA("BasePart") then
  		descendant:Destroy()
  	end
  end
  ```

Instance:ClearAllChildren

Fungsi ini menghancurkan semua anak instansi.

Demonstrates cloning a model using `Class.Instance:Clone()`.

`Clone()` membuat salinan instansi dan semua keturunannnya, mengabaikan semua instansi yang tidak `Class.Instance.Archivable|Archivable` .Salinan instansi akar dikembalikan oleh metode ini dan `Class.Instance.Parent|Parent` nya diatur ke `nil` .Perhatikan bahwa jika instance itu sendiri memiliki `Class.Instance.Archivable|Archivable` diatur ke `false` , fungsi ini akan kembali `nil` .

  Jika properti referensi seperti `Class.ObjectValue.Value` ditetapkan di instansi yang diklon, nilai properti salinan tergantung pada nilai asli:

  *   Jika properti referensi merujuk pada instansi yang telah **juga** diklon, salinan akan merujuk pada salinan.
  *   Jika properti referensi merujuk ke objek yang tidak **tidak** diklon, nilai yang sama dipertahankan dalam salinan.

Instance:Clone

Buat salinan instansi dan semua keturunannya, mengabaikan instansi yang tidak `Class.Instance.Archivable|Archivable` .

Menunjukkan menghancurkan Suku Cadang menggunakan fungsi `Class.Instance:Destroy()`.

  Fungsi ini adalah cara yang benar untuk menyingkirkan objek yang tidak lagi diperlukan.

Atur properti `Class.Instance.Parent` ke `nil` , mengunci properti `Class.Instance.Parent` , memutus semua koneksi, dan memanggil `Destroy()` pada semua anak.Fungsi ini adalah cara yang benar untuk menyingkirkan objek yang tidak lagi diperlukan.

  Menyingkirkan objek yang tidak diperlukan penting, karena objek dan koneksi yang tidak perlu di tempat menggunakan memori yang dapat menyebabkan masalah kinerja serius seiring waktu.

  Sebagai praktik terbaik setelah memanggil `Destroy()` pada objek, atur variabel apa pun yang merujuk pada objek (atau keturunannnya) ke `nil` .Ini mencegah kode Anda mengakses apa pun yang berhubungan dengan objek.

  ```lua
  local part = Instance.new("Part")
  part.Name = "Hello, world"
  part:Destroy()
  -- Jangan lakukan ini:
  print(part.Name)  --> "Halo, dunia"
  -- Lakukan ini untuk mencegah baris di atas tidak berfungsi:
  part = nil
  ```

  Setelah `Class.Instance` dihancurkan dengan metode ini, tidak dapat digunakan kembali karena properti `Class.Instance.Parent` terkunci.Untuk **sementara** menghapus objek alih-alih menghancurkannya, atur `Class.Instance.Parent|Parent` ke `nil`.Sebagai contoh:

  ```
  local Workspace = game:GetService("Workspace")

  object.Parent = nil
  task.wait(2)
  object.Parent = Workspace
  ```

  Untuk menghancurkan objek setelah jumlah waktu tertentu, gunakan `Class.Debris:AddItem()` .

Instance:Destroy

Atur properti `Class.Instance.Parent` ke `nil` , mengunci properti `Class.Instance.Parent` , memutus semua koneksi, dan memanggil `Destroy()` pada semua anak.

Kembalikan nenek moyang pertama dari `Class.Instance` yang `Class.Instance.Name` sama dengan nama yang diberikan.

  Fungsi ini bekerja ke atas, artinya dimulai pada langsung instansi `Class.Instance.Parent` dan bekerja menuju `Class.DataModel` .Jika tidak ada leluhur yang cocok ditemukan, ia kembalikan `nil` .

  Potongan kode berikut akan menemukan nenek moyang pertama dari objek bernama `Car` .

  ```
  local car = object:FindFirstAncestor("Car")
  ```

  Untuk varian fungsi ini yang menemukan leluhur kelas tertentu, silakan lihat `Class.Instance:FindFirstAncestorOfClass()` dan `Class.Instance:FindFirstAncestorWhichIsA()` .

Instance:FindFirstAncestor

name

Kembalikan nenek moyang pertama dari `Class.Instance` yang `Class.Instance.Name` sama dengan nama yang diberikan.

Kembalikan nenek moyang pertama dari `Class.Instance` yang `Class.Object.ClassName` sama dengan kelas yang diberikan.

  Fungsi ini bekerja ke atas, artinya dimulai pada langsung instansi `Class.Instance.Parent` dan bekerja menuju `Class.DataModel` .Jika tidak ada leluhur yang cocok ditemukan, ia kembalikan `nil` .

  Penggunaan umum dari fungsi ini adalah menemukan `Class.Model` milik `Class.BasePart` . Misalnya:

  ```
  local model = part:FindFirstAncestorOfClass("Model")
  ```

  Fungsi ini adalah variasi dari `Class.Instance:FindFirstAncestor()` yang memeriksa properti `Class.Object.ClassName` bukan `Class.Instance.Name`.`Class.Instance:FindFirstAncestorWhichIsA()` juga ada, menggunakan metode `Class.Object:IsA()` untuk menghormati warisan kelas.

Instance:FindFirstAncestorOfClass

className

The `Class.Object.ClassName` untuk dicari.

Kembalikan nenek moyang pertama dari `Class.Instance` yang `Class.Object.ClassName` sama dengan kelas yang diberikan.

Kembalikan nenek moyang pertama dari `Class.Instance` untuk siapa `Class.Object:IsA()` kembali benar untuk kelas yang diberikan.

  Fungsi ini bekerja ke atas, artinya dimulai pada langsung instansi `Class.Instance.Parent` dan bekerja menuju `Class.DataModel` .Jika tidak ada leluhur yang cocok ditemukan, ia kembalikan `nil` .

  Tidak seperti `Class.Instance:FindFirstAncestorOfClass()` , fungsi ini menggunakan `Class.Object:IsA()` yang menghormati warisan kelas. Misalnya:

  ```
  print(part:IsA("Part"))  --> true
  print(part:IsA("BasePart"))  --> true
  print(part:IsA("Instance"))  --> true
  ```

  Oleh karena itu, sampel kode berikut akan mengembalikan nenek moyang pertama `Class.BasePart` , terlepas dari apakah itu adalah `Class.WedgePart` , `Class.MeshPart` atau `Class.Part` .

  ```
  local part = object:FindFirstAncestorWhichIsA("BasePart")
  ```

  Lihat juga `Class.Instance:FindFirstAncestor()` .

Instance:FindFirstAncestorWhichIsA

Kembalikan nenek moyang pertama dari `Class.Instance` untuk siapa `Class.Object:IsA()` kembali benar untuk kelas yang diberikan.

Yang berikut akan mencari di Workspace untuk nama objek "Brick". Jika ditemukan, itu akan mengubah nama objek menjadi "Foo".

Kembalikan anak pertama dari `Class.Instance` dengan nama yang diberikan, atau `nil` jika tidak ada anak seperti itu.Jika argumen opsional `recursive` opsional adalah `true` , fungsi ini mencari semua keturunan daripada hanya anak-anak langsung dari `Class.Instance` .

  ##### Memeriksa Keberadaan Objek

  `FindFirstChild()` diperlukan jika Anda perlu memverifikasi objek ada sebelum melanjutkan.Mencoba mengindeks anak dengan nama menggunakan operator dot memunculkan kesalahan jika anak tidak ada.

  ```lua
  local Workspace = game:GetService("Workspace")

  -- Kesalahan baris berikut jika bagian tidak ada di ruang kerja
  Workspace.Part.Transparency = 0.5
  ```

  Pendekatan yang lebih baik adalah menggunakan `FindFirstChild()` untuk memeriksa `Part` terlebih dahulu, lalu gunakan pernyataan `if` untuk menjalankan kode yang membutuhkannya.

  ```lua
  local Workspace = game:GetService("Workspace")

  local part = Workspace:FindFirstChild("Part")
  if part then
  	part.Transparency = 0.5
  end
  ```

  ##### Menemukan Anak yang Nama Nya Sesuai dengan Properti

  Terkadang `Class.Instance.Name|Name` dari objek adalah sama dengan properti dari objeknya `Class.Instance.Parent|Parent` .Saat menggunakan operator dot, properti memiliki prioritas lebih tinggi atas anak-anak jika mereka berbagi nama.

  Dalam contoh berikut, `Class.Folder` yang disebut `Color` ditambahkan ke `Class.Part` , yang juga memiliki properti `Class.Part.Color`.Perhatikan bahwa `part.Color` merujuk pada nilai properti `Datatype.Color3` , bukan anak `Class.Folder` instansi.Manfaat menggunakan `Class.Instance:FindFirstChild()|FindFirstChild()` adalah bahwa pengenalan properti baru tidak memberikan risiko pada kode Anda.

  ```lua
  local part = Instance.new("Part")
  local folder = Instance.new("Folder")
  folder.Name = "Color"
  folder.Parent = part
  local c1 = part.Color  -- Kepemilikan
  local c2 = part:FindFirstChild("Color")  -- The child folder
  ```

  ##### Catatan Kinerja

  `Class.Instance:FindFirstChild()|FindFirstChild()` membutuhkan waktu sekitar 20% lebih lama dari menggunakan operator dot dan hampir 8 kali lebih lama dari sekadar menyimpan referensi ke objek.Oleh karena itu, Anda harus menghindari memanggilnya dalam kode bergantung pada kinerja seperti di loop ketat atau fungsi yang terhubung ke `Class.RunService.Heartbeat` dan `Class.RunService.PreRender` .Sebagai gantinya, simpan hasil dalam variabel, atau pertimbangkan untuk menggunakan `Class.Instance.ChildAdded|ChildAdded` atau `Class.Instance:WaitForChild()|WaitForChild()` untuk mendeteksi kapan anak dari nama tertentu menjadi tersedia.

Instance:FindFirstChild

The `Class.Instance.Name` yang harus dicari.

recursive

Apakah pencarian harus dilakukan secara berulang atau tidak.

Kembalikan anak pertama dari `Class.Instance` yang ditemukan dengan nama yang diberikan.

Kembalikan anak pertama dari `Class.Instance` yang `Class.Object.ClassName|ClassName` sama dengan yang diberikan `className` .Tidak seperti `Class.Instance:FindFirstChildWhichIsA()` , fungsi ini hanya mengembalikan objek yang kelasnya cocok dengan `className` , mengabaikan warisan kelas.Jika anak yang cocok tidak ditemukan, fungsi ini akan mengembalikan `nil` .

Instance:FindFirstChildOfClass

Kembalikan anak pertama dari `Class.Instance` yang `Class.Object.ClassName|ClassName` sama dengan nama kelas yang diberikan.

Kembalikan anak pertama dari `Class.Instance` untuk siapa `Class.Object:IsA()` kembali benar untuk kelas yang diberikan.

  Jika tidak ada anak yang cocok ditemukan, fungsi ini返回 `nil` .Jika argumen recursif opsional benar, fungsi ini mencari semua keturunan daripada hanya anak-anak langsung dari `Class.Instance` .

  Tidak seperti `Class.Instance:FindFirstChildOfClass()` , fungsi ini menggunakan `Class.Object:IsA()` yang menghormati warisan kelas. Misalnya:

  ```lua
  print(part:IsA("Part")) --> benar
  print(part:IsA("BasePart")) --> benar
  print(part:IsA("Instance")) --> true
  ```

  Oleh karena itu, sampel kode berikut akan mengembalikan anak pertama `Class.BasePart` , terlepas dari apakah itu adalah `Class.WedgePart` , `Class.MeshPart` atau `Class.Part` .

  ```
  local part = object:FindFirstChildWhichIsA("BasePart")
  ```

  Pengembang yang mencari anak dengan nama, harus menggunakan `Class.Instance:FindFirstChild()` sebagai gantinya.

Instance:FindFirstChildWhichIsA

The `Class.Object.ClassName` yang harus dicari.

Kembalikan anak pertama dari `Class.Instance` untuk siapa `Class.Object:IsA()` kembali benar untuk kelas yang diberikan.

Kembalikan keturunan pertama yang ditemukan dengan `Class.Instance.Name` yang diberikan.

  Metode ini dinonaktifkan dan tidak dapat digunakan.Untuk menemukan keturunan pertama dari instansi, pertimbangkan menggunakan parameter `recursive` pada `Class.Instance:FindFirstChild()` sebagai gantinya.

Instance:FindFirstDescendant

Kembalikan keturunan pertama yang ditemukan dengan `Class.Instance.Name` yang diberikan.

Jika `Class.Instance` adalah `Class.Actor` , maka `Class.Actor` sendiri dikembalikan.Jika tidak, leluhur terdekatnya `Class.Actor` dikembalikan.Jika tidak ada leluhur adalah `Class.Actor` , hasilnya adalah `nil` .

Instance:GetActor

Kembalikan `Class.Actor` yang terkait dengan Instansi, jika ada.

Metode ini mengembalikan nilai yang telah ditugaskan ke nama atribut yang diberikan. Jika tidak ada atribut yang ditugaskan, `nil` dikembalikan.

  Sebagai contoh, potongan kode berikut menetapkan dan kemudian mendapatkan nilai atribut instance `InitialPosition`:

  ```lua
  local Workspace = game:GetService("Workspace")

  local part = Workspace.Part
  part:SetAttribute("InitialPosition", part.Position)

  local initialPosition = instance:GetAttribute("InitialPosition")
  print(initialPosition)
  ```

  ##### Lihat Juga

  *   `Class.Instance:SetAttribute()` yang mengatur atribut dengan nama yang diberikan ke nilai yang diberikan.
  *   `Class.Instance:GetAttributes()` yang men返ikan kamus pasangan kunci-nilai untuk setiap atribut instansi.

Instance:GetAttribute

Nilai yang telah ditugaskan ke nama atribut yang diberikan. Jika tidak ada atribut yang ditugaskan, `nil` dikembalikan.

Kembalikan nilai yang telah ditugaskan ke nama atribut yang diberikan.

Fungsi ini mengembalikan peristiwa yang berperilaku persis seperti peristiwa `Class.Object.Changed|Changed` , kecuali bahwa itu hanya menembak ketika atribut tertentu berubah; secara efektif itu mirip dengan `Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()` tetapi untuk atribut.

  Secara umum, ide yang baik adalah menggunakan metode ini alih-alih koneksi ke `Class.Object.Changed|Changed` dengan fungsi yang memeriksa nama atribut.Panggilan berikutnya ke metode ini pada objek yang sama dengan nama atribut yang sama mengembalikan peristiwa yang sama.

  Contoh kode berikut mengembalikan sinyal yang memicu fungsi `attributeChanged()` ketika atribut bagian `InitialPosition` berubah:

  ```lua
  local Workspace = game:GetService("Workspace")

  local part = Workspace.Part
  part:SetAttribute("InitialPosition", part.Position)

  local function attributeChanged()
  	print("Attribute changed")
  end

  part:GetAttributeChangedSignal("InitialPosition"):Connect(attributeChanged)
  ```

  Lihat juga `Class.Instance.AttributeChanged` yang menembak setiap kali ada atribut yang diubah pada instans.

Instance:GetAttributeChangedSignal

Nama atribut yang ditentukan untuk mana sinyal perubahan dikembalikan.

Sebuah peristiwa yang menembak ketika atribut yang diberikan berubah.

Kembalikan acara yang terbakar saat atribut yang diberikan berubah.

Metode ini mengembalikan kamus pasangan kunci-nilai untuk setiap atribut di mana kunci adalah nama atribut dan nilainya adalah nilai non-`nil` .

  Sebagai contoh, potongan kode berikut menampilkan atribut dan nilai instansi:

  ```lua
  local Workspace = game:GetService("Workspace")

  local part = Workspace.Part
  part:SetAttribute("InitialPosition", part.Position)
  part:SetAttribute("CanUse", true)

  for name, value in part:GetAttributes() do
  	print(name .. " = " .. value)
  end
  ```

  Lihat juga `Class.Instance:GetAttribute()` yang men返ikan nilai yang telah ditugaskan ke nama atribut yang diberikan.

Instance:GetAttributes

Kamus pasangan string → varian untuk setiap atribut di mana string adalah nama atribut dan varian adalah nilai non-nol.

The below would print the name of all objects currently in Workspace when ran.

Kembalikan array (tabel berindeks numerik) yang berisi semua anak langsung instansi, atau setiap `Class.Instance` yang `Class.Instance.Parent|Parent` sama dengan objek.배열 dapat diulang saat menggunakan loop for numerik atau umum:

  ```lua
  local Workspace = game:GetService("Workspace")

  -- Contoh lop loop numerik
  local children = Workspace:GetChildren()
  for i = 1, #children do
  	local child = children[i]
  	print(child.Name .. " is child number " .. i)
  end
  ```

  ```lua
  local Workspace = game:GetService("Workspace")

  -- Contoh lop loop umum
  local children = Workspace:GetChildren()
  for i, child in children do
  	print(child.Name .. " is child number " .. i)
  end
  ```

  Anak-anak diurutkan berdasarkan urutan di mana properti `Class.Instance.Parent|Parent` mereka ditetapkan ke objek.

  Lihat juga fungsi `Class.Instance:GetDescendants()|GetDescendants`.

Instance:GetChildren

Sebuah array yang berisi anak-anak instansi.

Kembalikan array yang berisi semua anak instansi.

Kembalikan string terkode dari ID debug yang digunakan secara internal oleh Roblox. Perhatikan bahwa:

  *   Item ini dilindungi. Mencoba menggunakannya di `Class.Script` atau `Class.LocalScript` akan menyebabkan kesalahan.
  *   ID debug adalah ID yang digunakan dalam proses debugging.Ini memungkinkan debugger untuk membaca setiap instruksi sebelum aplikasi memprosesnya.Semua objek di Roblox bertindak seperti proses dan setiap instruksi jalankan (atau 'kode') yang dapat di debug jika diperlukan.
  *   Ini bisa membantu untuk plugin yang perlu membedakan objek serupa dari satu sama lain (seperti objek yang berbagi nama yang sama).

Instance:GetDebugId

scopeLength

Kembalikan string terkode dari ID debug yang digunakan secara internal oleh Roblox.

GetDescendants is often used to do something to all the descendants that are a
particular type of object. The code in this example uses GetDescendants and
`Class.Instance:IsA()` to find all of the parts in the workspace and turns
them green.

Metode objek ini mem返回 array yang berisi semua keturunan dari objek itu.Tidak seperti `Class.Instance:GetChildren()` , yang hanya mengembalikan anak-anak langsung dari objek, metode ini menemukan setiap anak dari objek, setiap anak dari anak-anak itu, dan seterusnya.

Instance:GetDescendants

Sebuah array yang berisi keturunan instansi.

Kembalikan array yang berisi semua keturunan instansi.

This code sample demonstrates the behavior of `Class.Instance:GetFullName()`.
It shows how the function behaves when called on an object not in the
`DataModel` hierarchy, and it also shows how the return value does not escape
special characters.

This code sample re-implements the `Class.Instance:GetFullName()` function in
Lua.

Kembalikan string yang menjelaskan leluhur instansi.String adalah koncatenasi dari `Class.Instance.Name|Name` objek dan leluhurnya, dipisahkan oleh periode.The `Class.DataModel` ( `game` ) tidak dipertimbangkan.Sebagai contoh, `Class.Part` di `Class.Workspace` mungkin kembali `Class.Workspace.Part` .

  Ketika dipanggil pada `Class.Instance` yang bukan keturunan dari `Class.DataModel` , fungsi ini mempertimbangkan semua nenek moyang hingga dan termasuk yang paling atas tanpa `Class.Instance.Parent|Parent` .

  Fungsi ini berguna untuk pencatatan dan debugging.Anda tidak boleh mencoba memecahkan string yang dikembalikan untuk operasi yang berguna; fungsi ini tidak melarikan periode (atau simbol lain) dalam nama objek.Dengan kata lain, meskipun outputnya sering tampak menjadi identifikasi Luau yang valid, tidak dijamin.

Instance:GetFullName

Kembalikan string yang menjelaskan leluhur instansi.

Metode ini mengembalikan nilai gaya atau secara eksplisit dimodifikasi dari properti yang ditentukan, atau nilai properti default jika belum ditata/dimodifikasi.Ini berbeda sedikit dari mengakses nilai properti secara langsung, seperti `[GuiObject].Rotation` , yang men返ikan nilai default atau modifikasi properti.

  ```lua
  local Players = game:GetService("Players")
  local ReplicatedStorage = game:GetService("ReplicatedStorage")

  local player = Players.LocalPlayer
  local playerGui = player.PlayerGui
  local HUDContainer = playerGui:WaitForChild("HUDContainer")

  local coreSheet = ReplicatedStorage:FindFirstChild("CoreSheet")
  local rule = coreSheet:FindFirstChildWhichIsA("StyleRule")
  rule.Selector = "TextButton"

  -- Referensi ke tombol
  local button = HUDContainer:FindFirstChildWhichIsA("TextButton")

  print(button:GetStyled("Rotation")) --> 0 (nilai default)
  print(button.Rotation) --> 0 (nilai default)

  -- Terapkan rotasi melalui properti aturan gaya
  rule:SetProperty("Rotation", 30)

  print(button:GetStyled("Rotation")) --> 30 (nilai bergaya berdasarkan aturan)
  print(button.Rotation) --> 0 (nilai default)

  -- Secara eksplisit mengubah/menghapus properti berstyling
  button.Rotation = 45

  print(button:GetStyled("Rotation")) --> 45 (nilai yang dimodifikasi)
  print(button.Rotation) --> 45 (modified value)
  ```

Instance:GetStyled

Nilai bergaya atau secara eksplisit dimodifikasi dari properti yang ditentukan, atau nilai properti default jika belum diubah/dimodifikasi.

Kembalikan nilai bergaya atau secara eksplisit dimodifikasi dari properti yang ditentukan, atau nilai properti default jika belum diberi gaya/dimodifikasi.

Metode ini men返回事件 yang berperilaku persis seperti event `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged`, kecuali bahwa itu hanya menembak ketika properti gaya yang diberikan berubah.Secara umum, ide yang baik adalah menggunakan metode ini alih-alih koneksi ke `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` dengan fungsi yang memeriksa nama properti.Panggilan berikutnya ke metode ini pada objek yang sama dengan nama properti yang sama mengembalikan peristiwa yang sama.

  Perhatikan bahwa acara ini tidak akan mengirimkan argumen ke fungsi terhubung, jadi nilai properti yang diubah harus dibaca langsung dalam skrip.

  ```lua
  local Players = game:GetService("Players")

  local player = Players.LocalPlayer
  local playerGui = player.PlayerGui
  local HUDContainer = playerGui:WaitForChild("HUDContainer")
  local meterBar = HUDContainer.MeterBar

  local function stylePropertyChanged()
  	print("Style property changed!")
  end

  meterBar:GetStyledPropertyChangedSignal("AnchorPoint"):Connect(stylePropertyChanged)
  ```

Instance:GetStyledPropertyChangedSignal

property

Nama properti gaya untuk mendengarkan perubahan.

Peristiwa yang menembak ketika properti gaya yang diberikan berubah.

Metode ini mengembalikan array tag yang diterapkan pada instans yang diberikan, sebagai string.Anda dapat menambahkan tag di Studio di jendela [Properti](/studio/properties) atau saat menjalankan dengan `Class.Instance:AddTag()|AddTag()` .

  Metode ini berguna ketika Anda ingin melakukan sesuatu dengan beberapa tag pada instan sekaligus.Namun, tidak efisien menggunakan metode ini untuk memeriksa keberadaan tag tunggal; sebagai gantinya, gunakan `Class.Instance:HasTag()|HasTag()` untuk memeriksa tag khusus.

Instance:GetTags

Mendapatkan array dari semua tag yang diterapkan ke instansi.

Metode ini mengembalikan `true` jika tag yang disediakan telah ditambahkan ke objek.Anda dapat menambahkan tag baik di Studio di jendela [Properti](/studio/properties) atau saat menjalankan dengan `Class.Instance:AddTag()|AddTag()`.

Instance:HasTag

Periksa apakah instansi memiliki tag yang diberikan.

Demonstrates determining if one instance is the ancestor of another using `Class.Instance:IsAncestorOf()`

Workspace and SpawnLocation are ancestors of the SpawnLocation's decal.
Workspace is an ancestor of SpawnLocation.

SpawnLocation and its decal are descendants of Workspace, not ancenstors.
Decal is a descendant to SpawnLocation, not an ancestor.

Kembalikan benar jika `Class.Instance` adalah leluhur dari keturunan yang diberikan.

  Sebuah `Class.Instance` dianggap sebagai leluhur dari objek jika objeknya `Class.Instance.Parent` atau salah satu dari orangtuanya `Class.Instance.Parent` diatur ke `Class.Instance`.

  Lihat juga, `Class.Instance:IsDescendantOf()` .

Instance:IsAncestorOf

Benar jika `Class.Instance` adalah leluhur dari keturunan yang diberikan.

Kembalikan benar jika `Class.Instance` adalah leluhur dari keturunan yang diberikan.

Kembalikan `true` jika `Class.Instance` adalah keturunan dari leluhur yang diberikan.

  Perhatikan bahwa `IsDescendantOf()` tidak dapat digunakan dengan parameter `nil` untuk memeriksa apakah objek telah dihapus.

  Lihat juga `Class.Instance:IsAncestorOf()` .

Instance:IsDescendantOf

ancestor

Benar jika `Class.Instance` adalah keturunan dari leluhur yang diberikan.

Kembalikan `true` jika `Class.Instance` adalah keturunan dari leluhur yang diberikan.

Kembalikan `true` jika nilai yang disimpan dalam properti yang ditentukan sama dengan kode yang diinstanisasi default. Misalnya, jika mengekspor properti `Class.TextLabel.TextSize|TextSize` dari `Class.TextLabel` menunjukkan `8` , maka memanggil `IsPropertyModified("TextSize")` pada label akan mengembalikan `false` karena `8` adalah nilai default untuk `Class.TextLabel.TextSize` ketika label dibuat melalui `Instance.new("TextLabel")` alih-alih dimasukkan melalui alur pekerjaan penyisipan Studio.

  Perhatikan bahwa jika metode ini mengembalikan , penataan tidak akan mempengaruhi properti karena secara eksplisit memodifikasi properti lebih berprioritas daripada menatahkannya.

Instance:IsPropertyModified

Boolean menunjukkan apakah properti dimodifikasi.

Kembalikan `true` jika nilai yang disimpan dalam properti yang ditentukan sama dengan kode yang diinstanisasi default.

The following code demonstrates how a part can be re-added to the DataModel
after being removed:

Fungsi ini menetapkan `Class.Instance.Parent` objek menjadi `nil` , dan melakukan hal yang sama untuk semua keturunannnya.

  Jika objek di referensikan sebelum dihapus, mungkin untuk mengambil kembali objek pada titik kemudian.

Instance:Remove

Atur objek `Parent` ke `nil` , dan lakukan hal yang sama untuk semua keturunannya.

Instance

`Instance` adalah kelas dasar untuk semua kelas dalam hierarki kelas Roblox yang dapat menjadi bagian dari pohon `Class.DataModel`.

/reference/engine/classes/InsertService.yaml

InsertService

Rangkuman

Properti

Metode

Acara

Properti

AllowClientInsertModels

Metode

CreateMeshPartAsync

Parameter

Memberikan nilai

GetFreeDecals

Parameter

Memberikan nilai

Contoh Kode

GetFreeModels

Parameter

Memberikan nilai

Contoh Kode

GetLatestAssetVersionAsync

Parameter

Memberikan nilai

LoadAsset

Parameter

Memberikan nilai

Contoh Kode

LoadAssetVersion

Parameter

Memberikan nilai

Contoh Kode

Acara