Blueprints

Generado a partir de UBhapticsSDK2.

El target de todos los nodos es "Bhaptics SDK2".

---

Funciones para reproducir háptica basada en eventos

Reproduce los patrones hápticos vinculados a eventos hápticos específicos creados desde Designer/Portal. Se recomienda encarecidamente utilizar estas funciones.

Play Haptic

Reproduce el evento háptico. Es la forma más básica de invocar un evento háptico. Tiene la menor sobrecarga de todas las funciones de invocación de eventos hápticos.

Entradas

Tipo	Nombre	Descripción
exec	In
String	Event Id	Nombre del evento háptico que desea reproducir.

Salidas

Tipo	Nombre	Descripción
exec	Out
Integer	Return Value	Request ID. Puede usar el Request ID para detener la háptica. Devuelve -1 si la llamada falla.

Play Haptic With Option

Reproduce el evento háptico ajustando la intensidad, la duración y la dirección de la háptica.

Entradas

Tipo	Nombre	Descripción
exec	In
String	Event Id	Nombre del evento háptico que desea reproducir.
Float	Intensity	La Intensity háptica se multiplica por este valor.
Float	Duration	La Duration háptica se multiplica por este valor.
Float	Angle X	Gira la háptica en sentido antihorario alrededor del Vector3.up global. Rango válido: [0.0f - 360.0f]
Float	Offset Y	Mueve la háptica hacia arriba o hacia abajo. Rango válido: [-0.5f - 0.5f]
Integer	Request Id	Especifica un Request ID en lugar de usar uno aleatorio. Los valores válidos son 0 o mayores. Si se omite o es negativo, se asigna un ID aleatorio.

Reutilizar un Request ID

Normalmente, si reproduce una háptica mientras otra háptica todavía se está reproduciendo, la nueva reproducción se ejecuta sobre la actual. Sin embargo, si la reproduce con el mismo Event Id y Request Id que la háptica actual, la reproducción actual se detiene y comienza la nueva. Así, cada háptica se percibe de forma más definida y se evita que las hápticas se acumulen cuando se reproducen repetidamente a intervalos cortos.

Salidas

Tipo	Nombre	Descripción
exec	Out
Integer	Return Value	Request ID. Puede usar el Request ID para detener la háptica. Devuelve -1 si la llamada falla.

Play Haptic With StartTime

Reproduce el evento háptico desde una posición de inicio determinada, ajustando la intensidad, la duración y la dirección de la háptica.

Entradas

Tipo	Nombre	Descripción
exec	In
String	Event Id	Nombre del evento háptico que desea reproducir.
Integer	Start Millis	Posición de inicio de la reproducción en milisegundos. Los primeros Start Millis milisegundos del evento se omiten (esto es un Offset de inicio, no un retraso antes de la reproducción). Solo Windows/macOS/Android.
Float	Intensity	La Intensity háptica se multiplica por este valor.
Float	Duration	La Duration háptica se multiplica por este valor.
Float	Angle X	Gira la háptica en sentido antihorario alrededor del Vector3.up global. Rango válido: [0.0f - 360.0f]
Float	Offset Y	Mueve la háptica hacia arriba o hacia abajo. Rango válido: [-0.5f - 0.5f]
Integer	Request Id	Especifica un Request ID en lugar de usar uno aleatorio. Los valores válidos son 0 o mayores. Si se omite o es negativo, se asigna un ID aleatorio.

Reutilizar un Request ID

Normalmente, si reproduce una háptica mientras otra háptica todavía se está reproduciendo, la nueva reproducción se ejecuta sobre la actual. Sin embargo, si la reproduce con el mismo Event Id y Request Id que la háptica actual, la reproducción actual se detiene y comienza la nueva. Así, cada háptica se percibe de forma más definida y se evita que las hápticas se acumulen cuando se reproducen repetidamente a intervalos cortos.

Salidas

Tipo	Nombre	Descripción
exec	Out
Integer	Return Value	Request ID. Puede usar el Request ID para detener la háptica. Devuelve -1 si la llamada falla.

Play Loop

Reproduce la háptica de forma repetida. Además, al igual que la función PlayHapticWithOption, puede ajustar la intensidad, la duración y la dirección de la háptica.

Entradas

Tipo	Nombre	Descripción
exec	In
String	Event Id	Nombre del evento háptico que desea reproducir.
Float	Intensity	La Intensity háptica se multiplica por este valor.
Float	Duration	La Duration háptica se multiplica por este valor.
Float	Angle X	Gira la háptica en sentido antihorario alrededor del Vector3.up global. Rango válido: [0.0f - 360.0f]
Float	Offset Y	Mueve la háptica hacia arriba o hacia abajo. Rango válido: [-0.5f - 0.5f]
Integer	Interval	Intervalo de tiempo entre bucles, medido en milisegundos.
Integer	Max Count	Número de bucles.

Salidas

Tipo	Nombre	Descripción
exec	Out
Integer	Return Value	Request ID. Puede usar el Request ID para detener la háptica. Devuelve -1 si la llamada falla.

Funciones para reproducir háptica directamente

Si desea reproducir háptica sin crear un nuevo evento, use estas funciones.

Play Dot

Reproduce retroalimentación háptica en el actuador háptico específico. Puede usar esta función sin crear un evento.

Entradas

Tipo	Nombre	Descripción
exec	In
Integer	Position	Tipo de dispositivo háptico.
Array of Integers	Motor Values	Asigne la longitud del array según el número de motores del dispositivo. Los valores del array representan la Intensity de los motores. Rango válido para cada valor del array: [0 - 100]
Float	Seconds	La Duration de la háptica, medida en segundos. Se recomienda un valor mayor o igual a 0.1f.

• Position

  Valor	Dispositivo
  0	TactSuit Pro
  1	TactSleeve(Left)
  2	TactSleeve(Right)
  3	TactVisor
  4	Tactosy for Hands(Left)
  5	Tactosy for Hands(Right)
  6	Tactosy for Feet(Left)
  7	Tactosy for Feet(Right)
  8	TactGlove(Left)
  9	TactGlove(Right)

Salidas

Tipo	Nombre	Descripción
exec	Out
Integer	Return Value	Request ID. Puede usar el Request ID para detener la háptica. Devuelve -1 si la llamada falla.

Play Path

Reproduce háptica alrededor de coordenadas específicas. Consulte la referencia de la API de C++ para obtener más información.

[TactGlove DK3] Play Path no activa el motor de bobina de voz (VCM) de la muñeca en un guante DK3.

Entradas

Tipo	Nombre	Descripción
exec	In
Integer	Position	Tipo de dispositivo háptico.
Array of Floats	X	Asigne la coordenada X. Rango válido para cada valor del array: [0.0f - 1.0f]
Array of Floats	Y	Asigne la coordenada Y. Rango válido para cada valor del array: [0.0f - 1.0f]
Array of Integers	Motor Values	Asigne la longitud del array según el número de motores del dispositivo. Los valores del array representan la Intensity de los motores. Rango válido para cada valor del array: [0 - 100]
Float	Seconds	La Duration de la háptica, medida en segundos. Se recomienda un valor mayor o igual a 0.1f.

• Position

  Valor	Dispositivo
  0	TactSuit Pro
  1	TactSleeve(Left)
  2	TactSleeve(Right)
  3	TactVisor
  4	Tactosy for Hands(Left)
  5	Tactosy for Hands(Right)
  6	Tactosy for Feet(Left)
  7	Tactosy for Feet(Right)
  8	TactGlove(Left)
  9	TactGlove(Right)

Salidas

Tipo	Nombre	Descripción
exec	Out
Integer	Return Value	Request ID. Puede usar el Request ID para detener la háptica. Devuelve -1 si la llamada falla.

Play Waveform

Solo TactGlove. Reproduce háptica en TactGlove. A diferencia de usar "Play Dot", puede ajustar con precisión la Duration háptica y los cambios de Intensity de vibración. Esto permite una expresión aún más detallada de la retroalimentación háptica.

Cada array debe tener seis (TactGlove DK2) u ocho (TactGlove DK3) elementos, y los tres arrays deben tener la misma longitud.

Entradas

Tipo	Nombre	Descripción
exec	In
Integer	Position	Tipo de dispositivo háptico.
Array of Integers	Motor Intensities	Un array de intensidades de motor. Su longitud debe coincidir con el número de motores del TactGlove: seis (TactGlove DK2) u ocho (TactGlove DK3). Rango válido para cada valor del array: [0 - 100]
Array of EBhapticsGlovePlayTime Enums	Play Time Values	Un array con la misma longitud que Motor Intensities (seis para DK2, ocho para DK3), donde cada elemento representa un intervalo de tiempo de actuación, con el tiempo definido mediante los enums EBhapticsGlovePlayTime.
Array of EBhapticsGloveShapeValue Enums	Shape Values	Un array con la misma longitud que Motor Intensities (seis para DK2, ocho para DK3), donde cada elemento representa la forma de los cambios de Intensity háptica a lo largo del tiempo, especificada por los enums EBhapticsGloveShapeValue.
Integer	Frequency	[Solo TactGlove DK3] Frecuencia de vibración en Hz de los actuadores propios del guante DK3. El valor predeterminado es 80. No tiene efecto en guantes DK2 ni en la ruta universal (non-Windows/macOS). Solo Windows/macOS.
Integer	Repeat Count	Número de veces que se repite la forma de onda, a partir de 1. 0 la reproduce una vez. Solo Windows/macOS.

• Position

  Valor	Dispositivo
  8	TactGlove(Left)
  9	TactGlove(Right)

• Motor Intensities

  Índice del array	El motor está ubicado en…
  0	Punta del pulgar
  1	Punta del índice
  2	Punta del dedo medio
  3	Punta del dedo anular
  4	Punta del meñique
  5	En la muñeca
  6	En la palma (lado del pulgar)
  7	En la palma (lado del meñique)

• Play Time Values

  Valor	Duration	Equivale a…
  EBhapticsGlovePlayTime::None	Ninguna	0
  EBhapticsGlovePlayTime::FiveMS	5ms	1
  EBhapticsGlovePlayTime::TenMS	10ms	2
  EBhapticsGlovePlayTime::TwentyMS	20ms	4
  EBhapticsGlovePlayTime::ThirtyMS	30ms	6
  EBhapticsGlovePlayTime::FortyMS	40ms	8

• Shape Values

  Valor	Forma de onda	Equivale a…
  EBhapticsGloveShapeValue::Constant	Intensity constante durante la Duration	0
  EBhapticsGloveShapeValue::Decreasing	Comienza con la Intensity especificada y disminuye a la mitad	1
  EBhapticsGloveShapeValue::Increasing	Comienza con la mitad de la Intensity especificada y aumenta hasta la Intensity especificada.	2

Salidas

Tipo	Nombre	Descripción
exec	Out
Integer	Return Value	Request ID. Puede usar el Request ID para detener la háptica. Devuelve -1 si la llamada falla.

Otras funciones

Stop Haptic By Event Id

Detiene el evento háptico por Event ID. Devuelve si la detención fue exitosa.

Entradas

Tipo	Nombre	Descripción
exec	In
String	Event Id	Nombre del evento háptico que desea detener.

Salidas

Tipo	Nombre	Descripción
exec	Out
Boolean	Return Value	Si la detención fue exitosa.

Stop Haptic By Request Id

Detiene el evento háptico usando el Request ID devuelto por la función que ejecuta la háptica. Devuelve si la detención fue exitosa.

Entradas

Tipo	Nombre	Descripción
exec	In
Integer	Request Id	Request ID del evento háptico en reproducción que desea detener.

Salidas

Tipo	Nombre	Descripción
exec	Out
Boolean	Return Value	Si la detención fue exitosa.

Stop Haptic

Detiene toda la háptica que se esté reproduciendo actualmente. Devuelve si la detención fue exitosa.

Entradas

Tipo	Nombre	Descripción
exec	In

Salidas

Tipo	Nombre	Descripción
exec	Out
Boolean	Return Value	Si la detención fue exitosa.

Pause Haptic By Event Id

Pausa el evento háptico por Event ID. La posición de reproducción se mantiene para poder continuarla más tarde con "Resume Haptic By Event Id".

Entradas

Tipo	Nombre	Descripción
exec	In
String	Event Id	Nombre del evento háptico que desea pausar.

Salidas

Tipo	Nombre	Descripción
exec	Out

Resume Haptic By Event Id

Reanuda un evento háptico previamente pausado con "Pause Haptic By Event Id", continuando desde la posición donde se pausó.

Entradas

Tipo	Nombre	Descripción
exec	In
String	Event Id	Nombre del evento háptico que desea reanudar.

Salidas

Tipo	Nombre	Descripción

Is Playing

Comprueba si la háptica se está reproduciendo.

Entradas

Tipo	Nombre	Descripción
exec	In

Salidas

Tipo	Nombre	Descripción
exec	Out
Boolean	Return Value	Si el evento se está reproduciendo.

Is Playing By Event Id

Comprueba si el evento háptico con este Event ID se está reproduciendo.

Entradas

Tipo	Nombre	Descripción
exec	In
String	Event Id	Nombre del evento háptico cuya reproducción desea verificar.

Salidas

Tipo	Nombre	Descripción
exec	Out
Boolean	Return Value	Si el evento se está reproduciendo.

Is Playing By Request Id

Comprueba si el evento háptico con este Request ID se está reproduciendo.

Entradas

Tipo	Nombre	Descripción
exec	In
Integer	Request Id	Request ID del evento háptico cuya reproducción desea verificar.

Salidas

Tipo	Nombre	Descripción
exec	Out
Boolean	Return Value	Si el evento se está reproduciendo.

Initialize bHaptics

Inicializa el entorno háptico. Esta función debe llamarse antes de usar las funciones relacionadas con la háptica.

Entradas

Tipo	Nombre	Descripción
exec	In

Salidas

Tipo	Nombre	Descripción
exec	Out

Ping

Envía retroalimentación háptica simple a un dispositivo determinado.

Entradas

Tipo	Nombre	Descripción
exec	In
Bhaptics Device Structure	Device	Dispositivo al que desea enviar el ping.

Salidas

Tipo	Nombre	Descripción
exec	Out

Ping All

Envía retroalimentación háptica simple a todos los dispositivos conectados.

Entradas

Tipo	Nombre	Descripción
exec	In

Salidas

Tipo	Nombre	Descripción
exec	Out

Destroy bHaptics

Destruye el entorno háptico. Esta función debe llamarse cuando el juego finaliza, y debe llamarse UNA SOLA VEZ.

Entradas

Tipo	Nombre	Descripción
exec	In

Salidas

Tipo	Nombre	Descripción
exec	Out

Get bHaptics devices

Obtiene un array con la información de los dispositivos hápticos conectados.

Entradas

Tipo	Nombre	Descripción
exec	In

Salidas

Tipo	Nombre	Descripción
exec	Out
Array of Bhaptics Device Structures	Return Value	Lista de dispositivos.

Is bHaptics Available

Comprueba si el entorno háptico está inicializado y listo para usar las funciones relacionadas con la háptica.

Entradas

Tipo	Nombre	Descripción
exec	In

Salidas

Tipo	Nombre	Descripción
exec	Out
Boolean	Return Value	Si el entorno de bHaptics está disponible.

Project To Vest With Player Collision Object

Función auxiliar para calcular los valores de Offset (ángulo y altura) de un punto de contacto de colisión dado respecto al jugador. Estos valores de Offset pueden usarse en PlayHapticWithOption y PlayLoop, que permiten ajustar la posición háptica.

Esta función asume que la dirección frontal se alinea con la parte delantera del chaleco, y la posición del jugador se considera el origen.

Consulte la referencia de la API de C++ para obtener más información.

Entradas

Tipo	Nombre	Descripción
Vector	Contact Location	Punto de contacto en coordenadas globales.
Primitive Component Object Reference	Player Component	Referencia al componente primitivo adjunto al jugador.
Float	Half Height	La mitad de la altura real del jugador, medida en centímetros.

Salidas

Tipo	Nombre	Descripción
Bhaptics Rotation Option Structure	Return Value	Valores de Offset.

Project To Vest With Player Location/Position

Función auxiliar para calcular valores de Offset a partir de una ubicación de contacto e información de transformación del jugador. Es similar a "Project To Vest", pero solo calcula el Offset de ángulo (Offset Angle X). La altura (Offset Y) siempre será 0.

Entradas

Tipo	Nombre	Descripción
Vector	Contact Location	Punto de contacto en coordenadas globales.
Vector	Player Location	Ubicación del jugador.
Rotator	Player Rotation	Rotation del jugador.

Salidas

Tipo	Nombre	Descripción
Bhaptics Rotation Option Structure	Return Value	Valores de Offset.

Custom Project To Vest

Función auxiliar para calcular valores de Offset a partir de una colisión. Realiza la misma función que "Project To Vest", pero permite cambiar los vectores Forward y Up.

Entradas

Tipo	Nombre	Descripción
Vector	Contact Location	Punto de contacto en coordenadas globales.
Primitive Component Object Reference	Player Component	Referencia al componente primitivo adjunto al jugador.
Float	Half Height	La mitad de la altura real del jugador, medida en centímetros.
Vector	Up Vector	Vector de dirección hacia arriba de referencia para el cálculo del Offset.
Vector	Forward Vector	Vector de dirección hacia adelante de referencia para el cálculo del Offset.

Salidas

Tipo	Nombre	Descripción
Bhaptics Rotation Option Structure	Return Value	Valores de Offset.