Skip to content

VKC Item Activity

VKCItemActivity_1

VKC Item Activity is a component for setting activities.
The "Activity" in Vket Cloud is a feature for wrapping models and scripts as a single Item, aimed for easy placement and implementation on worlds.

Available methods for this object type

Basic Settings

Label Function
Scene Preview Creates a preview object of the designated activity in Scene.
.json Designates the json file containing the activity information.
Overrides Edits the settings in each activity.

About Scene Preview

When enabling Scene Preview, a preview object of the activity will be created in Scene, which position / size / rotation can be altered.
However, the edits will be reverted on build, and Transform values of object with VKC Item Activity will be referred instead.

VKCItemActivity_2

Advanced Settings

Label Function
Clickable Toggles acceptance of click input from player
Auto Loading When enabled, this Item will be loaded automatically on world entrance.
As this Item must be explicitly loaded when Auto Loading is disabled, use Dynamic Loading or use Load() on HeliScript.
Item Render Priority Designates the Item's render priority.
For details, refer to RenderingSettings / Priority List
Show Photo Mode Toggles display/hide activity when in photo mode

Creating your own Activity

On SDK Ver12.x and later versions, a tool has been added to create/export your own Activity.
For details, please see VKC Activity Exporter.

About Edit Mode

The Edit Mode allows re-editing of exported Activity files on the Unity Editor.
When Edit Mode is set to On, a list of HeliScripts and Motions related to the activity will be shown, allowing to edit and configure.

Note that Scene Preview will be set to On when Edit Mode is enabled, which will disallow preview to be hidden.

VKCItemActivity_3

How to Edit Activity

For example, the AnalogClockActivity is edited by the instructions below.

VKCItemActivity_4

  • The "Activity" object in the image above is the object with VKC Item Activity component attached.
  • To add, delete, or edit an Activity, the objects under the root object with VKC Item Activity attached must be edited. Other objects outside the root object will not be saved to the Activity.
    For this case, the AnalogClockObject and its child objects located under Activity will be edited.

The objects under Activity can be edited in the scene view, by editing components such as Transform, etc.

VKCItemActivity_5

By selecting Off in VKC Item Activity's Edit Mode, the edited contents will be automatically saved.

VKCItemActivity_6

When save is successfully completed, a dialog as the image below will be shown.

VKCItemActivity_7


How to Download Activity

The Vket Cloud Activity can be downloaded from the asset store.

The asset store can be accessed by selecting "Asset Store" in the Vket Cloud MyPage after login.

VKCItemActivity_8

For details on how to use the asset store, refer to the manual page below. (English Version WIP) Gimmicks and Features ready to use! How to use the Vket Cloud Asset Store and Activities

How to Use

For example, the analog clock activity from the asset store is used here.
For details on how to get the activity data, refer to the manual which is referred later.

1. Unzip the downloaded Activity file. As unzipping instructions varies among OS, please use the method on your preference.

VKCItemActivity_9

2. Check the file contents, and make sure to read the README before use.

VKCItemActivity_10

3. Read the README's articles, especially the "Activity Settings" which contains the parameters for customizing the activity.

VKCItemActivity_11

4. Move the unzipped analogclock folder to the Unity project with the VketCloudSDK installed. Folder position within the Assets is at your choice.

VKCItemActivity_12

5. In an empty scene, place the essential components by right clicking and selecting "Add Essential Objects for Vket Cloud", and create an empty object for setting the activity.

VKCItemActivity_13

VKCItemActivity_14

6. Change the object name to AnalogClock or other names. (Avoid name conflicting with other objects.)

VKCItemActivity_15

7. Attach the VKC Item Activity component to the AnalogClock object.

VKCItemActivity_16

8. Set the activity\analogclock\AnalogClockActivity.json to the VKC Item Activity's json setting.

VKCItemActivity_17

9. Set a value for "useSecondHand" in VKC Item Activity's overrides. For details on the settings, refer to the "Activity Settings".

10. As the analog clock will appear on the object origin, adjust the placement position via Transform.

VKCItemActivity_18

11. Build and see if the analog clock appears.

VKCItemActivity_19