Mode Selfie

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

Pemain sudah mengambil tanggal tanggal untuk menghidangkan momen lucu dalam pengalaman. The Mode Selfie modul pengembang memungkinkan pemain untuk menangkap memori yang lebih bersih dari saat itu tanpa jendela chat atau daftar pemain, sementara juga mendukung efek filter, menyembunyikan karakter lain, dan posing.

Penggunaan Modul

Pemasangan

Untuk menggunakan modul SelfieMode dalam pengalaman:

  1. Dari tab Lihat, buka tab Kotak Alat dan pilih tab Toko Pencipta .

    Toolbox toggle button in Studio
  2. Pastikan Model penyortiran dipilih, lalu klik tombol Lihat Semua untuk Kategori .

  3. Temukan dan klik Modul Dev ubin.

  4. Lokasi modul Mode Selfie dan klik, atau seret-seret ke dalam pandangan 3D.

  5. Di jendela Explorer, pindahkan seluruh model SelfieMode ke ServerScriptService . Setelah mengeksekusi pengalaman, modul akan di distribusikan ke berbagai layanan dan mulai berjalan.

Konfigurasi

Modul ini telah dikonfigurasi untuk bekerja untuk kebanyakan kasus pengguna, tetapi Anda dapat dengan mudah menyesuaikannya melalui fungsi konfigurasikan.

  1. Dalam StarterPlayerScripts , buat LocalScript baru dan ganti nama menjadi Konfigurasi Mode Selfie .

  2. Tempaste kode berikut ke dalam naskah baru.

    Skrip Lokal - Konfigurasi Mode Selfie

    local ReplicatedStorage = game:GetService("ReplicatedStorage")
    local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
    SelfieMode.configure({
    disableCharacterMovement = true
    })

Gerakan Karakter

Mungkin menguntungkan untuk mencegah karakter pemain bergerak saat dalam mode selfie. Anda dapat mencapai ini dengan menetapkan disableCharacterMovement ke benar dalam panggilan konfigurasikan.

Skrip Lokal - Konfigurasi Mode Selfie

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
SelfieMode.configure({
disableCharacterMovement = true
})

Tindakan Mode Selfie

Mode Selfie datang dengan berbagai tindakan , masing-masing dari mana Anda dapat menggunakan dengan aktifkanAksi , 0> nonaktifkanAksi 0> , dan 3> toggleAksi 3> fungsi, atau mendeteksi melalui acara 6> aksiActivated 6> dan acara 9>

Kedalaman-Lapangan

Secara default, Mode Selfie menunjukkan efek kedalaman lapangan generik (blur subtil dari latar belakang) saat seorang pemain mengubah action.

Untuk mengubah efek kedalaman lapangan default, tetapkan depthOfFieldEffect ke instansi DepthOfFieldEffect Anda sendiri dalam panggilan konfigurasikan.

Skrip Lokal - Konfigurasi Mode Selfie

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
local customDepthOfField = Instance.new("DepthOfFieldEffect")
customDepthOfField.NearIntensity = 0
customDepthOfField.FarIntensity = 1
customDepthOfField.FocusDistance = 5
customDepthOfField.InFocusRadius = 5
SelfieMode.configure({
depthOfFieldEffect = customDepthOfField
})

Mengunci Pandangan

Tombol Lock Gaze menyebabkan karakter pemain menatap kamera saat menyiapkan posisi selfie, dalam jangkauan realistis seberapa jauh leher mereka bisa berputar.

Sembunyikan Orang Lain

Secara default, karakter lainnya terlihat berdampingan dengan karakter pemain. Pemain dapat mengobten tembakan solo yang sempurna dengan mengklik tombol Hide Others . Saat diaktifkan, karakter lainnya menghilang dari pandangan dan tetap tidak terlihat sampai tindakan mati.

Saring

Aksi Filtro memungkinkan pemain menerapkan filter prasetel dari opsi Pop , Lembut , 1> Antique1> , 4> Cute4> , 7> Dramatic7> , dan 9> Monokrom9>.

Pos

Aksi Pose memungkinkan pemain untuk memilih posisi prasetel dari opsi Cheer, Clapping, 2> Dolphin2>, 5> Flossing5>, 8> Guitar8>,

Referensi API

Jenis

Tindakan

Setiap tindakan diwakili oleh kamus dengan pasangan nilai kunci berikut:

KunciJenisDeskripsi
namestringNama action, ditunjukkan pertama di tooltips.
deskripsistringDeskripsi action, ditunjukkan setelah nama di tooltips.
iconstringID aset untuk ikon action.
activeIconstringID aset untuk ikon actiondi "aktif" negara. Hanya dapat digunakan pada tindakan orang tua, bukan tindakan sub.
actionstabelDaftar opsi sub-action. Ini memungkinkan Anda untuk membuat sub-menu dari berbagai tindakan lainnya.
parentTindakanOrang tua dari actionini; ini hanya berlaku untuk sub-tindakan dan menunjuk ke tindakan yang mengandungnya.
onActivatedfungsiFungsi panggilan op션 yang dijalankan saat seorang pemain mengaktifkan tindakan atau sub-tindakan. Biasanya, jika tindakan berisi sub-tindakan, hanya sub-tindakan yang memerlukan panggilan definisional sebagai cara untuk mengetahui bahwa pemain mengaktifkan sub-tindakan dan tidak hanya "mengekspansi" actionutama.
Skrip Lokal

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
SelfieMode.actionActivated:Connect(function(action)
print(action.name, "activated")
end)
SelfieMode.actionDeactivated:Connect(function(action)
print(action.name, "deactivated")
end)

Umum

Pemotretan Selfie.

SelfieMode datang dengan beberapa tindakan . Anda dapat menggunakan枚 ini dengan fungsi aktifkan tindakan , 0> nonaktifkan tindakan 0> , dan 3> toggleAction 3>.

NamaSintesis
DepthOfFieldMengacu pada actionKedalaman Lapangan.
LockGazeMengacu pada actionLock Gaze.
HideOthersMengacu pada actionSembunyikan Orang Lain.
FilterMengacu pada actionFiltro.
PoseMengacu pada actionPose.
Skrip Lokal

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
-- Aktifkan action"Filter"
SelfieMode.activateAction(SelfieMode.Action.Filter)

Fungsi

mengonfigurasi

mengonfigurasi(config: table )

Menggeser opsi konfigurasi default melalui kunci/值 berikut ini dalam tabel config . Fungsi ini hanya dapat dipanggil dari LocalScript .

KunciDeskripsiStandar
disableCharacterMovementJika benar, mencegah pengguna untuk bergerak saat mode selfie terbuka.benar
depthOfFieldEffectInstansi DepthOfFieldEffect khusus yang muncul ketika pemain mengubah tindakan Kedalaman Field.
Skrip Lokal - Konfigurasi Mode Selfie

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
SelfieMode.configure({
disableCharacterMovement = true
})

buka SelfieMode

buka SelfieMode()

Seorang pemain biasanya akan membuka mode selfie dengan tombol "kamera" di sisi kanan layar, tetapi fungsi ini memungkinkan Anda untuk membukanya melalui kode. Saat menerapkan tombol khusus seperti yang ditunjukkan di bawah, Anda harus menonaktifkan tombol default melalui setHudButtonEnabled. Fungsi ini hanya dapat diakses dari LocalScript .

Skrip Lokal

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
local button = script.Parent
-- Hapus tombol default
SelfieMode.setHudButtonEnabled(false)
-- Koneksikan tombol khusus
button.Activated:Connect(function()
SelfieMode.openSelfieMode()
end)

tutup SelfieMode

tutup SelfieMode()

Seorang pemain biasanya akan menutup mode selfie dengan tombol di bagian bawah layar, tetapi fungsi ini memungkinkan Anda untuk menutupnya melalui kode. Hanya dapat dipanggil dari LocalScript .

Skrip Lokal

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
SelfieMode.closeSelfieMode()

Apakah SelfieModeOpen

Apakah SelfieModeOpen?: boolean

Mengembalikan true jika mode selfie dibuka sebagai hasil dari tindakan pemain atau melalui bukaMode Selfie . Fungsi ini hanya dapat dipanggil dari LocalScript .

Skrip Lokal

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
SelfieMode.openSelfieMode()
print(SelfieMode.isSelfieModeOpen())

setHudButtonDiberiaktifkan

setHudButtonDiberdayakan()

Tetapkan apakah tombol default untuk masuk ke mode selfie ditunjukkan. Berguna saat menerapkan openSelfieMode melalui tombol UI khusus. Fungsi ini hanya dapat dipanggil dari LocalScript .

Skrip Lokal

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
local button = script.Parent
-- Hapus tombol default
SelfieMode.setHudButtonEnabled(false)
-- Koneksikan tombol khusus
button.Activated:Connect(function()
SelfieMode.openSelfieMode()
end)

mendapatkanTindakan

mendapatkanAction(action: SelfieMode.Action): Tindakan

Mendapatkan tipe Tindakan melalui menu SelfieMode.Action .

Skrip Lokal

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
local lockGazeAction = SelfieMode.getAction(SelfieMode.Action.LockGaze)

aktifkanTindakan

aktifkanAction(action: Mode Selfie.Actions )

Secara programatis mengaktifkan salah satu dari tindakan default tindakan. Ini sama dengan ketika seorang pemain menyalakan tindakan dari bar tindakan. Hanya dapat dipanggil dari LocalScript .

Skrip Lokal

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
-- Aktifkan action"Filter"
SelfieMode.activateAction(SelfieMode.Action.Filter)

deactivateTindakan

deactivateAction(action: Mode Selfie.Actions )

Secara programatis menonaktifkan salah satu dari tindakan default tindakan. Ini sama dengan ketika seorang pemain menyalakan tindakan dari bar tindakan. Hanya dapat dipanggil dari LocalScript .

Skrip Lokal

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
-- Nonaktifkan action"Filter"
SelfieMode.deactivateAction(SelfieMode.Action.Filter)

aktifkanTindakan

toggleAction(action: Mode Selfie.Actions): boolean

Mengubah tindakan pada jika itu mati, atau mengubahnya mati jika itu ada. Ini sama dengan ketika seorang pemain mengklik tindakan dari bar tindakan. Mengembalikan status baru "dijalankan" sebagai booleh. Hanya dapat dipanggil dari LocalScript .

Skrip Lokal

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
local lockGazeAction = SelfieMode.getAction(SelfieMode.Action.LockGaze)
local isEnabled = SelfieMode.toggleAction(lockGazeAction)
if isEnabled then
print("Activated", lockGazeAction.name)
else
print("Deactivated", lockGazeAction.name)
end

setTema

setTheme(theme: table )

Mengkonfigurasi tema mode selfie, termasuk ukuran teks, font, warna tombol/tipu, dan banyak lagi. Fungsi ini hanya dapat dipanggil dari LocalScript.

KunciDeskripsiStandar
textSizeUkuran semua teks.16
fontFont yang digunakan di seluruh UI ( Enum.Font ).GothamMedium
paddingPola utama digunakan untuk menempatkan elemen UI (UDim).(0, 12)
paddingSmallPad yang lebih kecil digunakan untuk menerapkan margin subtil antara elemen (UDim).(0, 6)
paddingScreenPad yang digunakan di sekitar sudut layar untuk memberi ruang nafas untuk mode selfie (UDim).(0, 24)
backgroundColorWarna latar belakang yang digunakan untuk bar yang menunjukkan tindakan ( Color3 ).[0, 0, 0]
scrollBarColorWarna scrollbar yang digunakan dalam elemen ScrollingFrame modul (Color3).[255, 255, 255]
Skrip Lokal

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
SelfieMode.setTheme({
textSize = 20,
font = Enum.Font.Michroma,
backgroundColor = Color3.fromRGB(0, 40, 75),
})

setAktif

setEnabled(isEnabled: boolean )

Tetapkan apakah mode selfie diaktifkan atau tidak. Saat dinonaktifkan, semua UI untuk modul dihapus dan semua acara diputus. Fungsi ini hanya dapat dipanggil dari LocalScript .

Skrip Lokal

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
SelfieMode.setEnabled(false)

Acara

自拍模式开启

Diaktifkan saat pemain membuka mode selfie atau saat openSelfieMode dipanggil. Acara ini hanya dapat terhubung dalam sebuah LocalScript .

Skrip Lokal

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
SelfieMode.selfieModeOpened:Connect(function()
print("Selfie mode open")
end)

selieModeTutup

Dibakar saat pemain menutup mode selfie atau saat closeSelfieMode dipanggil. Acara ini hanya dapat dihubungkan dalam LocalScript .

Skrip Lokal

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
SelfieMode.selfieModeClosed:Connect(function()
print("Selfie mode closed")
end)

aktif

Parameter
action: SelfieMode.ActionAksi yang aktif Action .

Diaktifkan ketika tindakan diaktifkan; ini mungkin salah satu tindakan utama seperti Kedalaman Field, Tahan Gaze, atau Sembunyikan Orang Lain; alternatifnya, itu mungkin sub-aktion seperti 2> filter

Skrip Lokal

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
SelfieMode.actionActivated:Connect(function(action)
print(action.name, "activated")
end)

aktif

Parameter
action: SelfieMode.ActionAksi yang tidak aktif Action .

Diaktifkan ketika tindakan utama atau tindakan sub-aktif diaktifkan. Fungsi terhubung menerima tindakan yang dideaktifkan Tindakan. Acara ini hanya dapat dihubungkan dalam LocalScript .

Skrip Lokal

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
SelfieMode.actionDeactivated:Connect(function(action)
print(action.name, "deactivated")
end)

filterBerubah

Parameter
newFilter: stringfilterbaru.
Filter Tua: stringfiltersebelumnya.

Mengaktifkan ketika filter diterapkan atau dihapus. Fungsi terhubung menerima nama filter baru dan nama filter lama. Acara ini hanya dapat dihubungkan di LocalScript .

Skrip Lokal

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
SelfieMode.filterChanged:Connect(function(newFilter, oldFilter)
print("Filter changed from", oldFilter, "to", newFilter)
end)

Berubah

Parameter
newPose: stringPosisi baru.
tuaPose: stringPosisi sebelumnya.

Diaktifkan ketika pose diterapkan atau dihapus. Fungsi terhubung menerima nama pose baru dan nama pose lama. Acara ini hanya dapat dihubungkan di dalam Class.LocalScript .

Skrip Lokal

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
SelfieMode.poseChanged:Connect(function(newPose, oldPose)
print("Pose changed from", oldPose, "to", newPose)
end)