Chế độ selfie

Người chơi đã chụp lại hình ảnh để ghi lại những khoảnh khắc vui vẻ trong trải nghiệm.Các mô-đun SelfieMode nhà phát triển cho phép người chơi thu nhận một bộ nhớ sạch sẽ hơn vào thời điểm đó mà không có cửa sổ trò chuyện hoặc danh sách người chơi, trong khi cũng hỗ trợ hiệu ứng lọc, che giấu các nhân vật khác và tạo dáng.

Sử dụng module

Cài đặt

Để sử dụng mô-đun Chế độ tự sướng trong một trải nghiệm:

1. Từ tab Xem, mở Hộp công cụ và chọn tab Cửa hàng Nhà sáng tạo .

   

2. Hãy chắc chắn rằng kiểu sắp xếp Mô hình được chọn, sau đó nhấp vào nút Xem tất cả đối với Danh mục .

   

3. Tìm và nhấp vào ô Dev Modules .

   

4. Tìm mô-đun Chế độ selfie và nhấp vào nó, hoặc kéo và thả nó vào cửa sổ 3D.

   

5. Trong cửa sổ Explorer, di chuyển toàn bộ mô hình SelfieMode vào ServerScriptService .Sau khi chạy trải nghiệm, mô-đun sẽ phân phối bản thân cho các dịch vụ khác nhau và bắt đầu chạy.

   

Cài đặt

Mô-đun được cài đặt sẵn để hoạt động cho hầu hết các trường hợp sử dụng, nhưng bạn có thể dễ dàng tùy chỉnh nó thông qua chức năng configure.

1. Trong StarterPlayerScripts , tạo một mới LocalScript và đổi tên thành Tùy chỉnh chế độ selfie .

2. Sao chép mã sau vào kịch bản mới.

   LocalScript - Tùy chỉnh chế độ selfie
   local ReplicatedStorage = game:GetService("ReplicatedStorage")
   
   local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
   
   SelfieMode.configure({
   	disableCharacterMovement = true
   })

Di chuyển nhân vật

Có thể có lợi khi ngăn chặn nhân vật của người chơi không di chuyển trong chế độ selfie.Bạn có thể đạt được điều này bằng cách đặt disableCharacterMovement thành true trong một cuộc gọi configure.

LocalScript - Tùy chỉnh chế độ selfie
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))

SelfieMode.configure({
	disableCharacterMovement = true
})

Hành động Chế độ Selfie

Chế độ tự sướng có đi kèm với các hành động sau , mỗi hành động bạn có thể sử dụng với kích hoạt hành động , vô hiệu hóa hành động và bật/tắt hành động của bạn, hoặc phát hiện thông qua các sự kiện hành độngActivated và hành độngDeactivated .

Chiều sâu của trường hợp

Mặc định, Chế độ tự sướng hiển thị một hiệu ứng chung độ sâu trường ảnh (mờ nhạt về nền) khi một người chơi chuyển đổi hành động.

Để thay đổi hiệu ứng độ sâu mặc định của trường, hãy đặt đến instance riêng của bạn trong một cuộc gọi configure .

LocalScript - Tùy chỉnh chế độ 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
})

Khóa nhìn

Chuyển đổi Khóa nhìn khiến nhân vật của người chơi nhìn vào máy ảnh trong khi thiết lập tư thế tự sướng, trong phạm vi có thực tế là bao xa cổ họ có thể quay.

Ẩn người khác

Mặc định, các nhân vật khác sẽ hiển thị cạnh nhân vật của người chơi.Người chơi có thể có được một phát bắn solo hoàn hảo bằng cách nhấp vào nút Hiden Others .Khi bật lên, các nhân vật khác biến mất khỏi tầm nhìn và vẫn vô hình cho đến khi hành động được tắt.

Bộ lọc

Hành động Lọc cho phép người chơi áp dụng một bộ lọc trước định từ các lựa chọn Pop , Mềm , Cổ điển , Dễ thương , Dramatic và Đơn sắc .

Tạo dáng

Hành động Pose cho phép người chơi chọn một tư thế được lưu từ các lựa chọn Cheer , Clapping , Dolphin , Flossing , Guitar , Jump Wave , Louder , Top Rock , Twirl và Wave .

Tham chiếu API

Loại

Hành động

Mỗi hành động được đại diện bởi một từ điển với các cặp chìa khóa-giá trị sau:

Tập lệnh địa phương
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)

Danh sách

Hành động SelfieMode.Action

Chế độ selfie có một số hành động .Bạn có thể sử dụng danh sách này với activateAction, deactivateAction, và toggleAction chức năng.

Tập lệnh địa phương
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))

-- Kích hoạt hành động "Lọc"
SelfieMode.activateAction(SelfieMode.Action.Filter)

Chức năng

điều chỉnh

Thay thế các tùy chọn cấu hình mặc định thông qua các chìa khóa/giá trị sau trong bảng config .Chức năng này chỉ có thể được gọi từ một LocalScript .

LocalScript - Tùy chỉnh chế độ selfie
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))

SelfieMode.configure({
	disableCharacterMovement = true
})

mở chế độ selfie

Một người chơi thường sẽ mở chế độ selfie với nút "máy ảnh" ở bên phải của màn hình, nhưng chức năng này cho phép bạn mở nó thông qua mã.Khi triển khai nút tùy chỉnh như được hiển thị dưới đây, bạn nên vô hiệu hóa nút mặc định thông qua setHudButtonEnabled.Chức năng này chỉ có thể được gọi từ một LocalScript .

Tập lệnh địa phương
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))

local button = script.Parent

-- Loại bỏ nút mặc định
SelfieMode.setHudButtonEnabled(false)

-- Kết nối nút tùy chỉnh
button.Activated:Connect(function()
	SelfieMode.openSelfieMode()
end)

đóng gói SelfieMode

Một người chơi thường sẽ đóng chế độ selfie với nút ⊗ ở dưới cùng của màn hình, nhưng chức năng này cho phép bạn đóng nó thông qua mã.Chỉ có thể được gọi từ một LocalScript .

Tập lệnh địa phương
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))

SelfieMode.closeSelfieMode()

là SelfieModeOpen

Trả về true nếu chế độ selfie được mở do hành động của người chơi hoặc thông qua mở chế độ selfie .Chức năng này chỉ có thể được gọi từ một LocalScript .

Tập lệnh địa phương
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))

SelfieMode.openSelfieMode()

print(SelfieMode.isSelfieModeOpen())

nhấn nút setHudButtonEnabled

Xác định xem nút mặc định để vào chế độ selfie có được hiển thị hay không.Hữu ích khi triển khai mở chế độ selfie thông qua nút UI tùy chỉnh.Chức năng này chỉ có thể được gọi từ một LocalScript .

Tập lệnh địa phương
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))

local button = script.Parent

-- Loại bỏ nút mặc định
SelfieMode.setHudButtonEnabled(false)

-- Kết nối nút tùy chỉnh
button.Activated:Connect(function()
	SelfieMode.openSelfieMode()
end)

nhận hành động

Nhận được một loại Hành động thông qua một SelfieMode.Action enum.

Tập lệnh địa phương
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))

local lockGazeAction = SelfieMode.getAction(SelfieMode.Action.LockGaze)

kích hoạt hành động

Kích hoạt một trong những hành động mặc định mặc định.Điều này giống như khi một người chơi chuyển đổi hành động từ thanh hành động.Chỉ có thể được gọi từ một LocalScript .

Tập lệnh địa phương
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))

-- Kích hoạt hành động "Lọc"
SelfieMode.activateAction(SelfieMode.Action.Filter)

Huỷ hoạt động deactivateAction

Vô hiệu hóa một trong những hành động mặc định mặc định .Điều này giống như khi một người chơi tắt hành động khỏi thanh hành động.Chỉ có thể được gọi từ một LocalScript .

Tập lệnh địa phương
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))

-- Vô hiệu hóa hành động "Lọc"
SelfieMode.deactivateAction(SelfieMode.Action.Filter)

切换行动 toggleAction

Bật/tắt một hành động trên if nếu nó tắt, hoặc tắt nó nếu nó bật.Điều này giống như khi một người chơi nhấp vào hành động từ thanh hành động.Trả về trạng thái mới "được bật" như một boolean.Chỉ có thể được gọi từ một LocalScript .

Tập lệnh địa phương
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

chủ đề setTheme

Cài đặt chủ đề chế độ selfie, bao gồm kích thước văn bản, phông chữ, màu nút/phím hướng dẫn và nhiều hơn nữa. Chức năng này chỉ có thể được gọi từ một LocalScript .

Tập lệnh địa phương
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),
})

bột được kích hoạt

Bộtùy chọn xác định liệu chế độ selfie được bật hay không.Khi bị vô hiệu hóa, tất cả các giao diện người dùng cho mô-đun sẽ bị xóa và tất cả các sự kiện sẽ bị tách rời.Chức năng này chỉ có thể được gọi từ một LocalScript .

Tập lệnh địa phương
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))

SelfieMode.setEnabled(false)

Sự kiện

selfieModeMở

Nổ khi người chơi mở chế độ selfie hoặc khi mở chế độ selfie được gọi. Sự kiện này chỉ có thể được kết nối trong một LocalScript .

Tập lệnh địa phương
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))

SelfieMode.selfieModeOpened:Connect(function()
	print("Selfie mode open")
end)

selfieModeClosed đã đóng

Bắt lửa khi người chơi đóng chế độ selfie hoặc khi closeSelfieMode được gọi. Sự kiện này chỉ có thể kết nối trong một LocalScript .

Tập lệnh địa phương
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))

SelfieMode.selfieModeClosed:Connect(function()
	print("Selfie mode closed")
end)

hành độngKích hoạt

Bắt lửa khi một hành động được kích hoạt; đây có thể là một trong những hành động chính như độ sâu trường lực , khóa nhìn , hoặc ẩn người khác ; hoặc có thể là một hành động phụ như một bộ lọc hoặc tư thế .Chức năng được kết nối nhận được hành động kích hoạt.Sự kiện này chỉ có thể kết nối trong một LocalScript .

Tập lệnh địa phương
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))

SelfieMode.actionActivated:Connect(function(action)
	print(action.name, "activated")
end)

hành độngVô hiệu hóa

Nổ khi một hành động chính hoặc hành động phụ được vô hiệu hóa.Chức năng được kết nối nhận được hành động bị vô hiệu hóa Action.Sự kiện này chỉ có thể được kết nối trong một LocalScript .

Tập lệnh địa phương
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))

SelfieMode.actionDeactivated:Connect(function(action)
	print(action.name, "deactivated")
end)

lọc thay đổi

Bắt lửa khi một bộ lọc được áp dụng hoặc loại bỏ.Chức năng kết nối nhận tên bộ lọc mới và tên bộ lọc cũ.Sự kiện này chỉ có thể được kết nối trong một LocalScript .

Tập lệnh địa phương
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)

đã thay đổi tư thế

Bắt lửa khi một tư thế được áp dụng hoặc loại bỏ.Chức năng kết nối nhận tên tư thế mới và tên tư thế cũ.Sự kiện này chỉ có thể được kết nối trong một LocalScript .

Tập lệnh địa phương
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)