# Carousel Component - Blank Canvas Tutorial

Please Note：This tutorial mainly explains how to use the Carousel Component to create playable **materials** for carousel-style gameplay. It is recommended to use it together with the [demo ](https://tinyurl.com/4mjzxhkz)and[ feature introduction document](https://doc.playturbo.com/playable-tools-content-editor/content-editor-user-guide/component-and-quick-layout/carousel-component) for a better understanding!

## <mark style="color:blue;">1. Basic Info</mark> <a href="#h5pts" id="h5pts"></a>

* \[Difficulty]: ⭐⭐
* \[Applicable Products]: Universal
* \[Interaction]: On carousel switch
* \[Freedom]: Fully free
* \[Core Assets]: Image
* \[Features]: Carousel Settings、Evevt-On carousel switch

## <mark style="color:blue;">2.Effect Preview</mark>

<table><thead><tr><th width="218.33333333333331">Best experience for playable on mobile devices</th><th width="255">Vertical screen</th><th>Horizontal screen</th></tr></thead><tbody><tr><td><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2Fll0NC4lJr4UOmsajiCUH%2Fimage.png?alt=media&#x26;token=ad1f83f9-8cc2-4598-9c00-bc7113608e7a" alt="" data-size="original"></td><td><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FQ9a1dQfrAq0HmtcqXbKy%2FAnimation3.gif?alt=media&#x26;token=ff49745f-7c4c-4873-afde-c59f609d3663" alt="" data-size="original"></td><td><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FctGfvTPRI5unaZd5GUVf%2FAnimation4.gif?alt=media&#x26;token=1d41584a-78eb-4feb-9ff8-1b2510b0b9ce" alt="" data-size="original"></td></tr><tr><td>Scan to play</td><td><a href="https://tinyurl.com/4mjzxhkz">Click to play</a></td><td><a href="https://tinyurl.com/4mjzxhkz">Click to play</a></td></tr></tbody></table>

## <mark style="color:blue;">3. Gameplay Overview</mark>

**Before starting the production, we need to outline the gameplay logic for this case：**

* Upon entering the trial, display \[character model A] and \[operation guide], guide the player to click the right arrow to switch the character's appearance.
* Player can click on any arrow or drag the character to switch to different appearances. Each interaction changes the character's appearance.
* Continue this interaction until the player presses the "Confirm" button to redirect to the ending scene.
* In the ending scene, when the player presses the button, redirect him to app store.

<div align="left"><figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FrxrCgQaNUv4jaoaBFUOU%2Fimage.png?alt=media&#x26;token=c59a9088-5b26-4ed5-ad9a-cfe0b1b0ef0e" alt="" width="497"><figcaption></figcaption></figure></div>

## <mark style="color:blue;">4.Production Approach</mark>

**Core Concept:** Minimize the number of animations and events within each scene, maintain clear logic in scene segmentation, and keep the layer structure simple.

**Scene Segmentation:** Based on the gameplay overview from the previous section, we can divide this case into 2 scenes for production.

<table><thead><tr><th width="180">Scene Name</th><th width="271">Scene 1 - Core Gameplay</th><th>Scene 2 - End Page</th></tr></thead><tbody><tr><td><strong>Visual Rendering</strong></td><td><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FYDnjvs6hRPX1WmPZTakw%2Fimage.png?alt=media&#x26;token=a7c15920-7873-4f06-a0c4-d9fe22e21df1" alt="" data-size="original"></td><td><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2F3Xepcr4GoCIwr5iqIJ1b%2Fimage.png?alt=media&#x26;token=19aa69b4-e270-42ec-bd27-b584854ba1cc" alt="" data-size="original"></td></tr><tr><td><strong>Scene Description</strong></td><td>Guide the player to click on the arrow to switch the character's appearance.</td><td>Product info &#x26; Redirect button</td></tr><tr><td><strong>Core Assets</strong></td><td><p><strong>Static Images:</strong> </p><p>Character models *3, Switch arrows, Instructions</p><p><strong>Audio-visual packaging:</strong></p><p>Flash particle effects, Click sound effect</p></td><td><p><strong>Static Images:</strong> </p><p>Background image, Redirect button</p><p><strong>Audio-visual packaging:</strong></p><p>Star particle effects</p></td></tr><tr><td><strong>Core Animations</strong></td><td><strong>Guiding finger &#x26; Confirmation button：</strong>PulseFront</td><td><strong>Redirect button:</strong> PulseFront</td></tr><tr><td><strong>Core Events</strong></td><td><p><strong>Trigger Object:</strong> Carousel Component</p><p><strong>Trigger Event:</strong> On carousel switch</p><p><strong>Response Event:</strong> Play animation feedback.</p></td><td><p><strong>Trigger Object:</strong> Redirect button</p><p><strong>Trigger Event:</strong> Press</p><p><strong>Response Event:</strong> Redirect to app store</p></td></tr></tbody></table>

## <mark style="color:blue;">5.</mark> <mark style="color:blue;"></mark><mark style="color:blue;">**Production Guidelines**</mark> <a href="#qh8tn" id="qh8tn"></a>

\*The core content consists of **Step 2"Component Parameter Setting,"** and **Step 5"Event Setting."**

### **Step 1 - Scene Setup** <a href="#znmfx" id="znmfx"></a>

It is recommended to upload all assets into the <mark style="color:red;">"Project Assets"</mark> after creating the project for easier access and usage in the future.

#### **1. Global Scene**

1）Add BGM and Background Image in the "Global Settings" section.

2）Add permanent download button, logo and other product information under \[Global Scene], and adjust the position and size of each asset. Group and sort the assets reasonably.

<figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FnKqjHSeY4FK5N8SbVpl7%2Fimage.png?alt=media&#x26;token=552e3bf6-3c88-44d4-adf1-869afe39ca09" alt=""><figcaption></figcaption></figure>

#### **2. Scene 1**

1）In Scene 1, click on "Gameplay Template" and select the Carousel Component from the "Component" to add it.

<div align="left"><figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FU9HclMGk1xulqJO8MNG2%2Fimage.png?alt=media&#x26;token=3c620041-0cc4-4fcb-aa94-5b9aade1eae4" alt="" width="411"><figcaption></figcaption></figure></div>

2）Add the guiding finger, guiding text, confirmation button, and click sound effect. Adjust the position and size of each asset.

<figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FGUL8eiCyf6YBtyHRTEzG%2Fimage.png?alt=media&#x26;token=d451a931-fdf8-4057-95af-fdc838f74094" alt=""><figcaption></figcaption></figure>

#### **3.Scene 2**

1）In Scene 2, add the product logo, redirect button, and background image. Adjust the size and blurry of the background image.&#x20;

<figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FIKHaxlRCMqJTiNPf08Hz%2Fimage.png?alt=media&#x26;token=a618419d-b7c7-4992-a341-4a08dba67bd3" alt=""><figcaption></figcaption></figure>

2）Check Scene 2 as the "Ending Scene," and disable "Global scene."

<div align="left"><figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FvcE8MXCRbopXuhtzO8FQ%2Fimage.png?alt=media&#x26;token=42f3c2bd-22b0-4f91-abc5-e6a6ff3e7b84" alt=""><figcaption></figcaption></figure></div>

### <mark style="color:red;">Step 2 - Component Parameter Setting</mark>

#### 1.Select Carousel Style

First, choose a suitable carousel style. In this case, we will use the "Fade zoom carousel" style.

<div align="left"><figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FyzTErhuvSxArcLRHsLMR%2Fimage.png?alt=media&#x26;token=65964edc-e0b3-4682-8347-e399b414e7e4" alt=""><figcaption></figcaption></figure></div>

#### 2.Set Carousel Resources

1）Click on the replace button to replace the initial carousel resource.

<div align="left"><figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FJOorPFeYCopjn71ta50F%2Fimage.png?alt=media&#x26;token=606729b4-5e63-43b9-be2f-a8eb2a20d34e" alt=""><figcaption></figcaption></figure></div>

2）Click on the "+" button to upload all carousel resources one by one (dragging can adjust the resource order).

<div align="left"><figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FVTGi1iPxAZHZZ6uxLJx7%2Fimage.png?alt=media&#x26;token=b37da82f-323a-4e44-8a08-3c789dbb57e9" alt=""><figcaption></figcaption></figure></div>

3）Adjust the "Slot size" of the carousel group, which determines the size of each image slot. In this case, we will set the slot size to 1200\*1200.

<figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FvAcC9Vdh10OhBOFnDDJO%2Fimage.png?alt=media&#x26;token=0acbdc1d-06ba-4a31-952f-73a47aeaa649" alt=""><figcaption></figcaption></figure>

#### 3.Slot configuration

The "Arrangement method" is set to default as horizontal, and the "Number of slots" is set to default as 3, with no adjustments made in this case.

<div align="left"><figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FxrUdp26upv8gn8Yf0IRs%2Fimage.png?alt=media&#x26;token=69e2f61c-9eeb-460c-8d52-28f4458a8497" alt=""><figcaption></figcaption></figure></div>

#### 4.Interaction methods

1）In this case, we choose the "Manual" carousel mode, and both "Tap" and "Drag" interaction modes are selected. This means that players can switch images either by clicking buttons or by dragging images.

2）Click on the replace button to replace the arrow image.

<div align="left"><figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FUbByolwDTjqBnLPv67Mr%2Fimage.png?alt=media&#x26;token=b491a3f2-d5de-4506-bc58-2d359bec2cac" alt=""><figcaption></figcaption></figure></div>

#### 5.Advanced settings&#x20;

The "Animation playback duration," "Opacity," and "Scale" can be left at their default values with no adjustments made in this case.

<div align="left"><figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FfrVM6QXAhD2laLX0Qrs7%2Fimage.png?alt=media&#x26;token=d787587c-3454-4694-9591-dc46c633cb10" alt=""><figcaption></figcaption></figure></div>

By completing the above steps, the parameters for Carousel Component are successfully set.

### Step 3 - Landscape & Portrait Orientation Adaptation

After completing the layout for portrait orientation, we need to adjust the "layout for landscape orientation" and the "screen adaptation for both landscape and portrait orientations."

#### 1. Adjust the layout for landscape orientation

1）In Scene 1, switch to landscape mode. Select all the top-level layers, including the Carousel Component, and use the "Reuse vertical screen position configuration" feature to automatically arrange them for landscape mode.&#x20;

<figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FQGvqaBBcm0VO0UJ5jf64%2Fimage.png?alt=media&#x26;token=04268dd8-61aa-4965-910e-57efc38525f0" alt=""><figcaption></figcaption></figure>

2）Then, individually adjust the **position** and **scale** of each layer to display the complete core gameplay-related content.&#x20;

<figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FDKeReUBSpUzRd03Lqbbc%2Fimage.png?alt=media&#x26;token=40d34512-ee85-4bd9-a000-26cd6ac426a6" alt=""><figcaption></figcaption></figure>

3）Similarly, repeat the process for Scene 2 and the Global Scene to complete the layout for landscape mode.

<figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FgUS5eXWC1A2NrhjbPJvL%2Fimage.png?alt=media&#x26;token=274ea824-2a62-4ce9-9229-41e6a30a3544" alt=""><figcaption><p>Scene 2</p></figcaption></figure>

<figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FaAED8nQpqJUyVXiM8h8B%2Fimage.png?alt=media&#x26;token=b51f0087-404c-4262-a444-82e4aaf06603" alt=""><figcaption><p>Global Scene</p></figcaption></figure>

#### 2.  Adjust the Screen adaptation

In this case, we can set the "Screen adaptation" of the product information group \[group\_info] as follows:

Set it to "Fit Top Left Corner" for landscape mode.

Set it to "Fit Top" for portrait mode.

Other layers remain centered by default and do not require adjustment.

<figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FBDKMqZ6fSoCi6yhO3nu9%2Fimage.png?alt=media&#x26;token=c70c3bd3-170f-46af-af28-b4b12baad0ce" alt=""><figcaption><p> landscape</p></figcaption></figure>

<figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FJlrd9swtuJGaj5SkqXEF%2Fimage.png?alt=media&#x26;token=6aaea251-a9f0-4a22-98fa-2645326dbc44" alt=""><figcaption><p>portrait</p></figcaption></figure>

### Step 4 - Animation Setting

In this case, the animations and particle effects used are as follows. Let's go through them one by one:

**Scene 1:** Guided finger click animation, confirmation button scaling animation, flash particle effects. **Scene 2:** Redirect button scaling animation, star particle effects.

#### 1. Guiding finger：PulseFront

Select the hand image \[gf\_hand], Add Animation - Emphasize - PulseFront, as a looping click animation. Set the parameters as follows:

<figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FQBBX9EcUZHERjRblnjzn%2Fimage.png?alt=media&#x26;token=274bbcab-fc80-473e-a5b4-9d07c68e8db1" alt=""><figcaption></figcaption></figure>

#### 2.Confirmation button：PulseFront

Copy this animation to the button group \[group\_btn], fine-tune the parameters, and disable auto-play, as a looping guided animation. Set the parameters as follows:

<figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2F7AziIitPdyPmKw1ZUvNA%2Fimage.png?alt=media&#x26;token=7aa295a6-5a4d-4010-ae47-eb6f0d2bacf7" alt=""><figcaption></figcaption></figure>

#### 3.Redirect button：PulseFront

Copy this animation to the redirect button group \[ctat] in Scene 2, fine-tune the parameters, as a looping guided animation. Set the parameters as follows:

<figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FwGJ0Tq4bB98THcAWZ77R%2Fimage.png?alt=media&#x26;token=721dbda5-7e10-4b57-a60f-f37805fcd2ee" alt=""><figcaption></figcaption></figure>

#### 4.Particle Effects

1）Open the "Asset Library"- "Particle", choose suitable particle effects (such as flash particles) to enhance the visual effect of the scene.

2）Adjust the position of the particles to suitable locations (remember to adjust for both portrait and landscape modes).

3）Note: Set the particles in Scene 1 to "Hidden" initially, and control their playback through events later.

<figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2F2mbNUUVkdTliDgyVkeN9%2Fimage.png?alt=media&#x26;token=d4738159-acc1-4f15-b402-1ee0b155aaab" alt=""><figcaption></figcaption></figure>

### <mark style="color:red;">Step 5 -</mark> <mark style="color:red;"></mark> <mark style="color:red;"></mark><mark style="color:red;">**Event**</mark> <mark style="color:red;"></mark><mark style="color:red;">Setting</mark> <a href="#lnpxj" id="lnpxj"></a>

To complete the setup of all animations, we need to configure the logic of the gameplay using "events."

The contents related to events and settings in this case include: &#x20;

* Playing a series of feedback effects when switching the carousel.
* Redirecting to the next scene when pressing the confirmation button.
* Redirecting to app store when pressing the redirect button.

Next, we will explain each step in sequence.

#### <mark style="color:red;">1. Layer: Carousel Component</mark>

Select the \[Carousel Component]. **Add Event - On carousel switch.** Add response events:

* Hide the guiding finger.
* Play the scaling animation of the confirmation button from the beginning.
* Show and play particle effects.
* Play the click sound effect once from the beginning.

<figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2Fyh2lFOKNEZz6z7binZQi%2Fimage.png?alt=media&#x26;token=5f89c240-b04c-48d9-9adb-6722d948f0fc" alt=""><figcaption></figcaption></figure>

#### 2. Layer: Confirmation button

Select the confirmation button group \[group\_btn].  **Add Event - Press**. &#x20;

Add response event: Redirect to the next scene.

<div align="left"><figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FUuafnXHKyopgcj78YuC6%2Fimage.png?alt=media&#x26;token=a48e9b35-6400-4ee6-8ee5-28b5e5f18efc" alt=""><figcaption></figcaption></figure></div>

#### 3.Layer: Redirect button group

Select the redirect button group \[ctat].  **Add Event - Press**. &#x20;

Add response event:Redirect to app store.

<div align="left"><figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FlYPYwoF7SE21ID07TgPI%2Fimage.png?alt=media&#x26;token=2227a202-78ee-4c49-8fab-6573f1a2df99" alt=""><figcaption></figcaption></figure></div>

#### 4. Layer: Persistent download button group

Copy this event to the persistent download button group \[ctat].

<div align="left"><figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FlYPYwoF7SE21ID07TgPI%2Fimage.png?alt=media&#x26;token=2227a202-78ee-4c49-8fab-6573f1a2df99" alt=""><figcaption></figcaption></figure></div>

These are all the events used in this case. With the completion of all event settings, our material is completed.

### Step 6 - Overall Preview <a href="#q96z9" id="q96z9"></a>

1）It is advisable to preview your work promptly after completing each step in the creation process to check if the settings are correct.

2）Once everything is completed, it is recommended to perform an overall preview on different devices, languages, and orientations to ensure everything is working correctly.

<figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FfhocoC0hZU14GbReyEFl%2Fimage.png?alt=media&#x26;token=c6921419-290b-43b2-9fb1-7bdea7b0b35e" alt=""><figcaption></figcaption></figure>

## <mark style="color:blue;">6.Assets Provision</mark>

At the end of the tutorial, we have **provided all the assets used in this case** for you. Click on the compressed file to download it.&#x20;

You can use these assets to follow the tutorial and try to make it, so that you can start using the Content Editor and Carousel Component to make such materials as soon as possible.

{% file src="<https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FkDcgMZbuvZ5OYutL0poc%2FCarousel%20Component_Blank%20Canvas_Assets.zip?alt=media&token=d23aff7f-2536-438d-b651-cbee0333bf5d>" %}
