Взаимодействие с контроллерами¶

Varwin SDK предоставляет компонент, позволяющий легко настраивать взаимодействие контроллеров с Varwin объектом.

Для этого необходимо добавить на Varwin объект компонент Interactable Object Behaviour.

В инспекторе устанавливаются желаемые настройки взаимодействия, а также могут быть добавлены обработчики событий.

Is Grabbable - объект можно брать в руки и перетаскивать;
Is Usable - объект можно использовать;
Is Touchable - контур объекта подсвечивается при нахождении контроллера в области объекта.

InteractableObjectBehaviour реализует публичные интерфейсы, необходимые для обработки событий ввода с контроллера.

IUseStartAware
IUseEndAware
IGrabStartAware
IGrabEndAware
ITouchStartAware
ITouchEndAware

Эти интерфейсы могут быть реализованы разработчиком самостоятельно при написании скриптов для Varwin объектов.

IUseStartAware¶

Достаточно реализовать любой из пары интерфейсов (IUseStartAware, IUseEndAware), чтобы объект можно было использовать.

public interface IUseStartAware : IVarwinInputAware
{
    void OnUseStart(UsingContext context);
}

OnUseStart вызывается при нажатии триггера контроллера или левой кнопки мыши. Принимает параметр типа UsingContext - ссылка на используемый контроллер, через нее можно получить ссылку на gameObject контроллера.

IUseEndAware¶

Достаточно реализовать любой из пары интерфейсов (IUseStartAware, IUseEndAware), чтобы объект можно было использовать.

public interface IUseEndAware : IVarwinInputAware
{
    void OnUseEnd();
}

OnUseEnd вызывается при отпускании триггера контроллера или левой кнопки мыши.

IGrabStartAware¶

Достаточно реализовать любой из пары интерфейсов (IGrabStartAware, IGrabEndAware), чтобы объект можно было хватать и переносить.

Реализация данного интерфейса подразумевает, что объект можно перетаскивать.

public interface IGrabStartAware : IVarwinInputAware
{
    void OnGrabStart(GrabingContext context);
}

OnGrabStart вызывается при нажатии захвата (grip) контроллера или правой кнопки мыши. Принимает параметр типа GrabbingContext - ссылка на используемый контроллер, через нее можно получить ссылку на gameObject контроллера.

IGrabEndAware¶

Достаточно реализовать любой из пары интерфейсов (IGrabStartAware, IGrabEndAware), чтобы объект можно было хватать и переносить.

public interface IGrabEndAware : IVarwinInputAware
{
    void OnGrabEnd();
}

OnGrabEnd вызывается при отпускании захвата (grip) контроллера или нажатии правой кнопки мыши (при условии, что объект уже в руке).

ITouchStartAware¶

Достаточно реализовать любой из пары интерфейсов (ITouchStartAware, ITouchEndAware), чтобы объект реагировал на касания.

public interface ITouchStartAware : IVarwinInputAware
{
    void OnTouchStart();
}

OnTouchStart вызывается при вхождении контроллера в область объекта.

ITouchEndAware¶

Достаточно реализовать любой из пары интерфейсов (ITouchStartAware, ITouchEndAware), чтобы объект реагировал на касания.

public interface ITouchEndAware : IVarwinInputAware
{
    void OnTouchEnd();
}

OnTouchEnd вызывается при выхождении контроллера из области объекта.

Другие интерфейсы для взаимодействия с контроллерами¶

IGrabPointAware¶

Предоставляет методы, позволяющие получить transform точки объекта, к которой присоединяется контроллер (для левого и правого контроллера соответственно). Вызывается в момент присоединения объекта к контроллеру (on grab).

public interface IGrabPointAware
{
    Transform GetLeftGrabPoint();
    Transform GetRightGrabPoint();
}

IPointerClickAware¶

public interface IPointerClickAware : IVarwinInputAware
{
    void OnPointerClick();
}

OnPointerClick вызывается при клике объекта лучом указки.

IPointerInAware¶

public interface IPointerInAware : IVarwinInputAware
{
    void OnPointerIn();
}

OnPointerIn вызывается при входе луча указки в область объекта.

IPointerOutAware¶

public interface IPointerOutAware : IVarwinInputAware
{
    void OnPointerOut();
}

OnPointerOut вызывается при выходе луча указки из области объекта.

Grab Settings Component¶

Если необходимо, чтобы объект ложился в руку определенным образом, можно воспользоваться компонентом Grab Settings. Он позволяет задать точки к которым будет прикрепляться контроллер (для правой и левой рук соответственно) в момент захвата объекта.