VRService

Quando definido para Enum.VRScaling.World , Camera.HeadScale ajusta para que a escala do mundo seja vista da perspectiva do avatar.Um jogador com um pequeno avatar perceberá os objetos ao redor deles como maiores do que um jogador com um avatar grande.

Quando definido como verdadeiro, um jogador de VR será capaz de animar suas mãos e cabeça usando seus controladores e óculosde ouvido.

Essa propriedade deve ser definida no servidor.

Quando verdadeiro, a visão de um jogador de VR desaparece para preto quando sua cabeça colide com um Objeto.Essa propriedade impede que os jogadores possam ver através das paredes enquanto estiverem na VR.O valor padrão é verdadeiro.

Essa propriedade descreve o que Enum.UserCFrame é responsável pela entrada na VR.Por instância, se um fone de ouvido VR for responsável, o valor dessa propriedade será Enum.UserCFrame.Head .

Para verificar se o Roblox detecta quaisquer dispositivos VR, que seriam responsáveis ​​pela entrada em VR, você pode verificar a propriedade VREnabled.

local VRService = game:GetService("VRService")

if VRService.VREnabled then
	print(VRService.GuiInputUserCFrame.Name)
else
	print("No VR device detected!")
end

Essa propriedade descreve se o usuário está usando um dispositivo de realidade virtual (VR).

Se um dispositivo VR estiver habilitado, você pode interagir com sua localização e movimento através de métodos como UserInputService:GetUserCFrame().Você também pode reagir ao movimento do dispositivo VR usando o evento UserInputService.UserCFrameChanged.

local UserInputService = game:GetService("UserInputService")

local isUsingVR = UserInputService.VREnabled
if isUsingVR then
	print("User is using a VR headset!")
else
	print("User is not using a VR headset!")
end

Essa propriedade só pode ser usada em um LocalScript .

Veja também

• Camera.HeadLocked
• UserInputService:GetUserCFrame()
• UserInputService.UserCFrameChanged

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
	-- Set the initial CFrame
	head.CFrame = VRService:GetUserCFrame(Enum.UserCFrame.Head)

	-- Track VR headset movement and mirror for character's head
	VRService.UserCFrameChanged:Connect(TrackHead)
end

Este método retorna o Enum.VRTouchpadMode indicando o modo de um especificado Enum.VRTouchpad .O modo retornado indica como o usuário interage com seu touchpad para jogar o jogo.

Isso também pode ser usado ao lado dos vários métodos e eventos UserInputService.

Este método só funcionará quando usado em um LocalScript .

Parâmetros

Devolução

local VRService = game:GetService("VRService")

VRService:GetTouchpadMode(Enum.VRTouchpad.Left)

Este método retorna um CFrame descrevendo a posição e orientação de um dispositivo de realidade virtual especificado como um deslocamento a partir de um ponto no espaço do mundo real.Este método deve ser usado ao implementar a compatibilidade de VR em um jogo para obter e rastrear o movimento de um dispositivo VR conectado.

Ao usar o método, os desenvolvedores podem implementar recursos como o reposicionamento do personagem do usuário no jogo correspondente à localização de um dispositivo VR conectado.Isso pode ser feito alterando o CFrame do personagem do usuário no jogo para combinar com o CFrame do dispositivo VR especificado usando os argumentos de valor da enumeração UserCFrame e CFrame transmitidos pelo evento.

VRService também fornece um evento UserCFrameChanged que atira automaticamente quando o CFrame do dispositivo VR conectado muda, desde que seja usado em um LocalScript .

Este método só funcionará quando usado em um LocalScript .

Parâmetros

Devolução

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)

-- Account for headscale
handOffset = handOffset.Rotation + handOffset.Position * camera.HeadScale
part.CFrame = camera.CFrame * handOffset

Este método retorna verdadeiro se o dispositivo de realidade virtual especificado Enum.UserCFrame estiver disponível para ser ouvido.Pode ser usado para determinar se um dispositivo VR especificado, como Enum.UserCFrame.Head, está conectado ao jogo do usuário.

Isso também pode ser usado ao lado dos vários métodos e eventos UserInputService.

Este método só funcionará quando usado em um LocalScript .

Parâmetros

Devolução

local VRService = game:GetService("VRService")

local isEnabled = VRService:GetUserCFrameEnabled(Enum.UserCFrame.Head)
if isEnabled then
	print("VR device is enabled!")
else
	print("VR device is disabled!")
end

Este método reposiciona o CFrame da cabeça do usuário na localização atual do fone de ouvido VR que o usuário está usando.Pode ser usado para garantir que a cabeça do usuário no jogo esteja posicionada de acordo com a localização do headset VR do usuário.

Isso se comporta de forma idêntica a UserInputService:RecenterUserHeadCFrame().

Este método só funcionará quando usado em um LocalScript .

Devolução

local VRService = game:GetService("VRService")

VRService:RecenterUserHeadCFrame()

Este método solicita navegação para o especificado CFrame usando o especificado Enum.UserCFrame como origem para a parábola visualizadora.Pode ser usado para incorporar realidade virtual (VR) em seu jogo fornecendo um meio de visualizar um caminho de navegação do dispositivo VR do usuário para um destino.

VRService tem um evento similar, NavigationRequested, usado para detectar tais solicitações.Isso também pode ser usado ao lado dos vários métodos e eventos VR UserInputService.

Este método só funcionará quando usado em um LocalScript .

Parâmetros

Devolução

local VRService = game:GetService("VRService")

local destination = workspace:FindFirstChild("NavigationDestination")

VRService:RequestNavigation(Enum.UserCFrame.Head, destination.CFrame)

Este método define o modo do especificado Enum.VRTouchpad para o especificado Enum.VRTouchpadMode.Pode ser usado para alterar o modo do touchpad de realidade virtual (VR) do usuário para que o usuário interaja com o jogo de forma diferente usando o touchpad.

Isso também pode ser usado ao lado dos vários métodos e eventos UserInputService.

Este método só funcionará quando usado em um LocalScript .

Parâmetros

Devolução

local VRService = game:GetService("VRService")

VRService:SetTouchpadMode(Enum.VRTouchpad.Left, Enum.VRTouchpadMode.Touch)

Este evento é disparado quando a navegação é solicitada de para um dispositivo VR especificado.Dispara com uma coordenada CFrame e o especificado Enum.UserCFrame indicando o dispositivo que solicita a navegação.

Este evento pode ser usado ao lado de UserInputService.

Como este evento é disparado localmente, ele só pode ser usado em um LocalScript .

Parâmetros

local VRService = game:GetService("VRService")

VRService.TouchpadModeChanged:Connect(function(cframe, inputUserCFrame)
	print(inputUserCFrame.Name .. " made request with CFrame: " .. cframe)
end)

Este evento dispara se o Enum.VRTouchpadMode de um Enum.VRTouchpad for alterado.Você pode usar esse evento para rastrear os estados dos tocadores VR conectados via o cliente do usuário.

Este evento pode ser usado ao lado de UserInputService.

Como este evento é disparado localmente, ele só pode ser usado em um LocalScript .

Parâmetros

local VRService = game:GetService("VRService")

VRService.NavigationRequested:Connect(function(pad, mode)
	print(pad.Name .. " Touchpad changed to state: " .. mode.Name)
end)

Este evento dispara quando um Enum.UserCFrame é alterado, por exemplo, quando o usuário move um dispositivo VR conectado.Pode ser usado ao lado de GetUserCFrame() para rastrear as coordenadas CFrame de um dispositivo VR e quando ele muda/muda.Também pode ser usado ao lado de UserInputService eventos e métodos de serviço.

Como este evento é disparado localmente, ele só pode ser usado em um LocalScript .

Parâmetros

local VRService = game:GetService("VRService")

VRService.UserCFrameChanged:Connect(function(userCFrameType, cframeValue)
	print(userCFrameType.Name .. " changed. Updated Frame: " .. tostring(cframeValue))
end)

Este evento dispara quando um Enum.UserCFrame é ativado ou desativado.Pode ser usado ao lado de GetUserCFrameEnabled() para rastrear se um UserCFrame especificado está habilitado e quando seu estado muda.Também pode ser usado ao lado de UserInputService eventos e métodos de serviço.

Como este evento é disparado localmente, ele só pode ser usado em um LocalScript .

Parâmetros

local VRService = game:GetService("VRService")

VRService.UserCFrameEnabled:Connect(function(type, enabled)
	if enabled then
		print(type.Name .. " got enabled!")
	else
		print(type.Name .. " got disabled!")
	end
end)