Chế độ selfie

Người chơi đã từ lâu lấy màn hình để đền tội những khoảnh khắc vui vẻ trong trải nghiệm. The SelfieMode module cho phép người chơi lưu một ký ức sạch hơn của thời điểm đó mà không có cửa sổ trò chuyện hoặc danh sách người chơi, khi hỗ

Sử dụng mô-đun

Cài đặt

Để sử dụng module SelfieMode trong một trải nghiệm:

1. Từ trang Xem, mở trang Hộp công cụ và chọn trang Cửa hàng Creator .

   

2. Đảm bạn chắn chọn Mô Hình sắp xếp, then click the Xem tất cả button for Các danh mục .

   

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

   

4. Tìm Chế độ selfie module và nhấp vào nó, hoặc kéo nó vào 3D view.

   

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

   

Tùy chỉnh

Cấu hình này đã được cấu hình để hoạt động cho hầu hết các trường hợp dùng, nhưng bạn có thể dễ dàng tùy chỉnh nó thông qua chức năng konfigure.

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

2. Sao chép mã sau đây vào một tập tin mới.

   LocalScript - Tùy chỉnh Chế độ Chụp ảnh
   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 ích khi ngăn chặn nhân vật của người chơi không di chuyển trong khi ở chế độ selfie. Bạn có thể thực hiện điều này bằng cách thiết lập disableCharacterMovement để true trong một cuộc gọi 配置 .

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

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

SelfieMode.configure({
	disableCharacterMovement = true
})

Hành động Chế độ Selfie

Chế độ selfie đi kèm với các hành động bên dưới , mỗi trong số которых bạn có thể sử dụng với kích hoạtHành động , 0> bỏ chọnHành động0> và 3> đổi chế độHà

Sâu trường ảnh

Bởi mặc định, Chế độ chụp ảnh tự sướng hiển thị một hiệu ứng depth-of-field genéric (ảo tưởng nhòa nền) khi một người chuyển đổi hành động.

Để thay đổi hiệu ứng độ sâu trường ảnh mặc định, hãy thiết lập depthOfFieldEffect đến đối tượng DepthOfFieldEffect của riêng bạn trong một cuộc gọi 配置 .

LocalScript - Tùy chỉnh Chế độ Chụp ảnh
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 mắt nhìn

Điều chỉnh Tương quan mắt bên trong dẫn đến việc người chơi nhìn vào máy ảnh trong khi cài đặt tương quan của cổ của họ, trong một phạm vi thực tế của ​​mức độ cúi xuống của họ có thể.

Ẩn người khác

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

Bộ lọc

Hành động Lọc cho phép người chơi ứng dụng một bộ lọc trước đã từ các tùy chọn Pop , Soft , 1> Antique1> , 4> Cute4> , 7> Dramatic7> và 0> Monochrome0> .

Đứng

Hành động Pose cho phép người chơi chọn một tư thế trước khi được Cheer , Clapping , 1> Dolphin1> , 4> Fl

Tham khảo API

Các loại

Hành động

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

Script đị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)

Số

Hành động Chụp ảnh

Chế độ selfie đi kèm với một số hành động . Bạn có thể sử dụng danh sách này với các chức năng kích hoạt hành động , 0> deactivateAction0> và 3> toggleAction3>.

Script đị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)

Hàm

điều chỉnh

Làm mất các lựa chọn cài đặt mặc định qua các chìa khóa/giá trị được đề xuất dưới đây 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ế độ Chụp ảnh
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 "camera" ở phía 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 thực hiện một nút tùy chỉnh như được hiển thị bên dưới, bạn nên tắt nút mặc định thông qua <

Script đị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 Chế độ selfie

Một người chơi sẽ thường đó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ể gọi từ một LocalScript .

Script địa phương
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

SelfieMode.closeSelfieMode()

isSelfieModeMở

Trả lại true nếu chế độ selfie được mở khiến bởi hành động của người chơi hoặc thông qua mở SelfieMode . Đây chỉ có thể được gọi từ một LocalScript .

Script địa phương
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

SelfieMode.openSelfieMode()

print(SelfieMode.isSelfieModeOpen())

setHudButtonĐã bật

Đặt whether the default button to enter selfie mode is shown. Useful when implementing openSelfieMode through a custom UI button. This function can only be called from a LocalScript .

Script đị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ậnAction

Nhận một Hành động kiểu thông qua một Hành động Hóa học danh sách.

Script địa phương
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

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

chủ động

Kích hoạt một trong những hành động mặc định một cách chương trình hóa . Đây là cùng một khi một người chuyển hướng hành động từ thanh hành động. Chỉ có thể được gọi từ một LocalScript .

Script đị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)

deactivateHành động

Lập trình bị tắt một trong những hành động mặc định này . Điều này giống như khi một người chơi bật hành động từ thanh hành động. Chỉ có thể được gọi từ một LocalScript .

Script đị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)

Bật/Tắt action

Bật/tắt một hành động trên if it's off, or toggles it off if it's on. This is the same as when a player clicks the action from the action bar. Trả lại giá trị mới "is toggled on" như một giá trị true. Chỉ có thể được gọi từ một Class.LocalScript .

Script đị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

đặt chủ đề

Tùy chỉnh chủ đề chụp ảnh tự sướng, bao gồm kích thước chữ, màu chữ, hình nền nút/mũi tên và nhiều thứ khác. Chức năng này chỉ có thể được gọi từ một LocalScript .

Script đị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

Làm cho biết có phải chế độ selfie được kích hoạt hay không. Khi bị tắt, tất cả UI cho modul được loại bỏ và tất cả các sự kiện được kết nối lại. Chức năng này chỉ có thể được gọi từ một LocalScript .

Script địa phương
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

SelfieMode.setEnabled(false)

Sự kiện

chế độ selfie mở

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

Script địa phương
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

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

chế độ selfie đóng

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ể được kết nối trong một LocalScript .

Script địa phương
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

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

hoạt độngBị kích hoạt

Làm nóng 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 của lòng sông , Khóa nhìn hoặc <

Script địa phương
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

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

actionĐã tắt

Kích hoạt khi một hành động chính hoặc thứ cấp được tắt. Chức năng kết nối nhận Hành động bị tắt. Sự kiện này chỉ có thể kết nối trong một LocalScript .

Script địa phương
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

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

đã thay đổi

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

Script đị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

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

Script đị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)