Cabine de fotos

Tirar uma foto é uma maneira perfeita de comemorar uma ótima experiência. O módulo de desenvolvedor PhotoBooth é uma ferramenta de preparo de fotos fácil de usar que permite que os jogadores atinjam um cargo único com um plano de fundo que representa sua experiência.

Uso do módulo

Instalação

Para usar o módulo PhotoBooth em uma experiência:

1. Na aba Exibir, abra a Caixa de ferramentas e selecione a aba Mercado.

   

2. Verifique se a ordenação de Modelos está selecionada e, em seguida, clique no botão Exibir Tudo para Categorias.

   

3. Encontre e clique no painel DEV MODULES

   

4. Localize o módulo Cabine de fotos e clique nele, ou arraste-o e solte-o em uma visualização 3D.

   

5. Na janela do Explorador, mova o modelo PhotoBooth inteiro para o ServerScriptService. Ao executar a experiência, o módulo será distribuído para vários serviços e começará a ser executado.

   

Posicionando a cabine

O módulo vem com um modelo PhotoBooth que você pode posicionar no mundo 3D. Esse modelo é o objeto com o qual os jogadores interagirão para configurar uma foto.

1. Localize a malha PhotoBooth dentro da pasta Espaço de trabalho da pasta principal do módulo.

   

2. Mova-a para a hierarquia mais alta do Espaço de trabalho e posicione-a onde desejar.

   

Configuração

O módulo é pré-configurado para funcionar na maioria dos casos de uso, mas pode ser facilmente personalizado por meio da função configurar. Por exemplo, para alterar a mensagem padrão na parte inferior da foto:

1. Em StarterPlayerScripts, crie um novo Class. LocalScript e renomeie-o para ConfigurePhotoBooth.

   

2. Cole o seguinte código dentro do script novo.

   LocalScript - ConfigurePhotoBooth
   local ReplicatedStorage = game:GetService("ReplicatedStorage")
   local PhotoBooth = require(ReplicatedStorage:WaitForChild("PhotoBooth"))
   PhotoBooth.configure({
    frameMessage = "First Photo Booth Capture!",
   })

   

Conexão com eventos

Toda vez que a cabine de fotos exibir uma nova tela para um cliente local, um evento correspondente será acionado. Esses eventos podem ser conectados em um Class. LocalScript para que você possa responder com sua própria lógica personalizada.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local PhotoBooth = require(ReplicatedStorage:WaitForChild("PhotoBooth"))
PhotoBooth.countdownStarted:Connect(function()
    print("The countdown has started")
end)
PhotoBooth.printoutShown:Connect(function()
    print("The printout is showing")
end)
PhotoBooth.promptShown:Connect(function()
    print("The camera prompt is showing")
end)

Visibilidade da interface gráfica

Por padrão, a cabine de fotos esconde todos os Class. ScreenGui|ScreenGuis e Class. CoreGui|CoreGuis quando a foto é tirada. Se você quiser substituir esse comportamento de ocultação automática e decidir programaticamente quais interfaces gráficas devem permanecer visíveis, inclua os retornos de chamada hideOtherGuis e showOtherGuis e responda com sua própria lógica personalizada.

LocalScript
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local StarterGui = game:GetService("StarterGui")
local PhotoBooth = require(ReplicatedStorage:WaitForChild("PhotoBooth"))
local player = Players. LocalPlayer
local playerGui = player:WaitForChild("PlayerGui")
local hiddenInstances = {}
-- Create a screen GUI that will not be hidden
local specialGuiInstance = Instance.new("ScreenGui")
-- Draw the screen GUI above the photo booth GUI
specialGuiInstance. DisplayOrder = 1
specialGuiInstance. Parent = playerGui
-- Set attribute on screen GUI to prevent hiding
specialGuiInstance:SetAttribute("ShowInPhotoBooth", true)
-- Add text label to the GUI
local specialLabel = Instance.new("TextLabel")
specialLabel. Size = UDim2.fromScale(1, 0.1)
specialLabel. Text = "Remains visible when taking a photo"
specialLabel. Font = Enum. Font. GothamMedium
specialLabel. TextSize = 24
specialLabel. Parent = specialGuiInstance PhotoBooth.hideOtherGuis(function()
    -- Hide all developer-defined screen GUIs except those marked with attribute
    local instances = playerGui:GetChildren()
    for _, instance in pairs(instances) do
        if instance:IsA("ScreenGui") and not instance:GetAttribute("ShowInPhotoBooth") and instance. Enabled then
            instance. Enabled = false
            table.insert(hiddenInstances, instance)
        end
    end
    -- Hide specific core GUIs
    StarterGui:SetCoreGuiEnabled(Enum. CoreGuiType. PlayerList, false)
end)
PhotoBooth.showOtherGuis(function()
    -- Show all developer-defined screen GUIs that were hidden
    for _, instance in pairs(hiddenInstances) do
        instance. Enabled = true
    end
    hiddenInstances = {}
    -- Show specific core GUIs that were hidden
    StarterGui:SetCoreGuiEnabled(Enum.

Referência de API

Funções

configurar

configure(config:table):nil

Substitui as opções de configuração padrão por meio das chaves-valor na tabela config. Esta função só poder ser chamada de um Class. LocalScript.

Aparência

Comportamento

Outros

LocalScript - ConfigurePhotoBooth
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local PhotoBooth = require(ReplicatedStorage:WaitForChild("PhotoBooth"))
PhotoBooth.configure({
    frameMessage = "What a cool pose!",
    fadeUiDelay = 5,
    maxActivationDistance = 5,
    printoutCharacterSize = UDim2.fromScale(1.5, 1.5),
})

setBackgrounds

setBackgrounds(backgrounds:table):nil

Substitui os fundos padrão fornecidos pela cabine de fotos. As imagens de fundo devem estar na proporção de 16:9 (1024×768) para uma experiência ideal e seus IDs de ativo devem ser incluídos na matriz de fundos. 1–4 (inclusivos) fundos podem ser fornecidos.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local PhotoBooth = require(ReplicatedStorage:WaitForChild("PhotoBooth"))
PhotoBooth.setBackgrounds({
    "rbxassetid://7018713114",
    "rbxassetid://950538356",
})

Eventos

countdownStarted

countdownStarted(): RBXScriptSignal

É acionado quando a contagem regressiva começa. O evento só pode ser conectado a um Class. LocalScript.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local PhotoBooth = require(ReplicatedStorage:WaitForChild("PhotoBooth"))
PhotoBooth.countdownStarted:Connect(function()
    print("The countdown has started")
end)

printoutShown

printoutShown(): RBXScriptSignal

É acionado quando a impressão é mostrada ao usuário. O evento só pode ser conectado a um Class. LocalScript.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local PhotoBooth = require(ReplicatedStorage:WaitForChild("PhotoBooth"))
PhotoBooth.printoutShown:Connect(function()
    print("The printout is showing")
end)

promptShown

promptShown(): RBXScriptSignal

É acionado quando a impressão é fechada e o botão da câmera é exibido novamente. O evento só pode ser conectado a um Class. LocalScript.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local PhotoBooth = require(ReplicatedStorage:WaitForChild("PhotoBooth"))
PhotoBooth.promptShown:Connect(function()
    print("The camera prompt is showing")
end)

Retornos de chamada

hideOtherGuis

hideOtherGuis(callback:function)

Esse retorno de chamada é executado imediatamente antes de a impressão ser exibida, permitindo que você desabilite Class. ScreenGui|ScreenGuis por completo ou elementos de dentro antes que a impressão seja mostrada. As interfaces gráficas usadas pela cabine de fotos têm o atributo ShowInPhotoBooth definido como true. Consulte Visibilidade da interface gráfica para obter detalhes e códigos de exemplo.

showOtherGuis

showOtherGuis(callback:function)

Esse retorno de chamada é exibido após o fechamento da impressão, permitindo que você reative Class. ScreenGui|ScreenGuis por completo ou elementos de dentro. As interfaces gráficas usadas pela cabine de fotos têm o atributo ShowInPhotoBooth definido como true. Consulte Visibilidade da interface gráfica para obter detalhes e códigos de exemplo.