Aprenda
Classe do mecanismo
VRService
Não criável
Serviço

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.


Amostras de código
VRService
local VRService = game:GetService("VRService")
local part = workspace.Part
local handOffset = VRService:GetUserCFrame(Enum.UserCFrame.LeftHand)
-- Leve em conta a escala da cabeça
handOffset = handOffset.Rotation + handOffset.Position * workspace.CurrentCamera.HeadScale
part.CFrame = workspace.CurrentCamera.CFrame * handOffset

Referência API
Propriedades
AutomaticScaling
Ler Parallel
Recursos: Input
VRService.AutomaticScaling:Enum.VRScaling

AvatarGestures
Ler Parallel
Recursos: Input
VRService.AvatarGestures:boolean

ControllerModels
Ler Parallel
Recursos: Input
VRService.ControllerModels:Enum.VRControllerModelMode

FadeOutViewOnCollision
Ler Parallel
Recursos: Input
VRService.FadeOutViewOnCollision:boolean

GuiInputUserCFrame
Não replicado
Ler Parallel
Recursos: Input
VRService.GuiInputUserCFrame:Enum.UserCFrame
Amostras de código
VRService.GuiInputUserCFrame
local VRService = game:GetService("VRService")
if VRService.VREnabled then
print(VRService.GuiInputUserCFrame.Name)
else
print("Nenhum dispositivo VR detectado!")
end

LaserPointer
Ler Parallel
Recursos: Input
VRService.LaserPointer:Enum.VRLaserPointerMode

ThirdPersonFollowCamEnabled
Somente leitura
Não replicado
Ler Parallel
Recursos: Input
VRService.ThirdPersonFollowCamEnabled:boolean

VREnabled
Somente leitura
Não replicado
Ler Parallel
Recursos: Input
VRService.VREnabled:boolean
Amostras de código
Rastreamento de Cabeça em VR
local VRService = game:GetService("VRService")
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local character = player.CharacterAdded:Wait()
local head = character:WaitForChild("Head")
local function TrackHead(inputType, value)
if inputType == Enum.UserCFrame.Head then
head.CFrame = value
end
end
if VRService.VREnabled then
-- Defina o CFrame inicial
head.CFrame = VRService:GetUserCFrame(Enum.UserCFrame.Head)
-- Rastreie o movimento do headset VR e espelhe para a cabeça do personagem
VRService.UserCFrameChanged:Connect(TrackHead)
end

Métodos
GetTouchpadMode
Recursos: Input
VRService:GetTouchpadMode(pad:Enum.VRTouchpad):Enum.VRTouchpadMode
Parâmetros
Amostras de código
Modo do Touchpad Esquerdo do VRService
local VRService = game:GetService("VRService")
-- Recupera o modo do touchpad esquerdo VRService:GetTouchpadMode(Enum.VRTouchpad.Left)

GetUserCFrame
Recursos: Input
VRService:GetUserCFrame(type:Enum.UserCFrame):CFrame
Parâmetros
Devolução
Amostras de código
VRService:GetUserCFrame
local Workspace = game:GetService("Workspace")
local VRService = game:GetService("VRService")
local camera = Workspace.CurrentCamera
local part = script.Parent.Part
local handOffset = VRService:GetUserCFrame(Enum.UserCFrame.LeftHand)
-- Levar em conta a escala da cabeça
handOffset = handOffset.Rotation + handOffset.Position * camera.HeadScale
part.CFrame = camera.CFrame * handOffset

GetUserCFrameEnabled
Recursos: Input
VRService:GetUserCFrameEnabled(type:Enum.UserCFrame):boolean
Parâmetros
Devolução
Amostras de código
VRService:GetUserCFrameEnabled
local VRService = game:GetService("VRService")
local isEnabled = VRService:GetUserCFrameEnabled(Enum.UserCFrame.Head)
if isEnabled then
print("O dispositivo VR está habilitado!")
else
print("O dispositivo VR está desabilitado!")
end

RecenterUserHeadCFrame
Recursos: Input
VRService:RecenterUserHeadCFrame():()
Devolução
()
Amostras de código
VRService:RecenterUserHeadCFrame
local VRService = game:GetService("VRService")
-- Recentralizando o CFrame da cabeça do usuário VRService:RecenterUserHeadCFrame()

RequestNavigation
Recursos: Input
VRService:RequestNavigation(
cframe:CFrame, inputUserCFrame:Enum.UserCFrame
):()
Parâmetros
cframe:CFrame
inputUserCFrame:Enum.UserCFrame
Devolução
()
Amostras de código
VRService:RequestNavigation
local VRService = game:GetService("VRService")
local destination = workspace:FindFirstChild("NavigationDestination")
VRService:RequestNavigation(Enum.UserCFrame.Head, destination.CFrame)

SetTouchpadMode
Recursos: Input
VRService:SetTouchpadMode(
):()
Devolução
()
Amostras de código
Modo do Touchpad do VRService
local VRService = game:GetService("VRService")
-- Define o modo do touchpad esquerdo VRService:SetTouchpadMode(Enum.VRTouchpad.Left, Enum.VRTouchpadMode.Touch)

Eventos
NavigationRequested
Recursos: Input
VRService.NavigationRequested(
cframe:CFrame, inputUserCFrame:Enum.UserCFrame
Parâmetros
cframe:CFrame
inputUserCFrame:Enum.UserCFrame
Amostras de código
VRService.NavigationRequested
local VRService = game:GetService("VRService")
VRService.NavigationRequested:Connect(function(cframe, inputUserCFrame)
print(inputUserCFrame.Name .. " fez a solicitação com CFrame: " .. cframe)
end)

TouchpadModeChanged
Recursos: Input
VRService.TouchpadModeChanged(
Amostras de código
VRService.TouchpadModeChanged
local VRService = game:GetService("VRService")
VRService.TouchpadModeChanged:Connect(function(pad, mode)
print(pad.Name .. " Touchpad mudou para o estado: " .. mode.Name)
end)

UserCFrameChanged
Recursos: Input
VRService.UserCFrameChanged(
Parâmetros
value:CFrame
Amostras de código
VRService.UserCFrameChanged
local VRService = game:GetService("VRService")
VRService.UserCFrameChanged:Connect(function(userCFrameType, cframeValue)
print(userCFrameType.Name .. " mudou. Quadro atualizado: " .. tostring(cframeValue))
end)

UserCFrameEnabled
Recursos: Input
VRService.UserCFrameEnabled(
type:Enum.UserCFrame, enabled:boolean
Parâmetros
enabled:boolean
Amostras de código
VRService.UserCFrameEnabled
local VRService = game:GetService("VRService")
VRService.UserCFrameEnabled:Connect(function(type, enabled)
if enabled then
print(type.Name .. " foi habilitado!")
else
print(type.Name .. " foi desabilitado!")
end
end)

©2026 Roblox Corporation, Roblox, o logotipo Roblox e Powering Imagination estão entre nossas marcas registradas e não registradas nos EUA e em outros países.