ZEPETO build it Template 指南
欢迎，ZEPETO 世界创造者！👋 ZEPETO Build it Unity Plug-in 是一个 Unity 世界开发插件，提供诸如免费使用 3D 资源和图像、用于创建跳跃地图的各种对象、用于销售自己物品的模特功能以及广告功能等功能。 在保留原始 Build It 体验的同时，它允许您轻松使用 Unity，而无需编码！ 在 ZEPETO 平台上启动您的虚拟空间，全球 4 亿 Z 世代用户都喜欢它。
- Build it Template 是试点测试期间使用的名称。正式名称已更改为 ZEPETO Build it Unity Plug-in，请注意！
概括 | ZEPETO Build it Unity Plug-in 允许您像 Build it 一样方便地创建地图。 |
|---|---|
困难 | 对于初学者 |
单人/多人游戏 | 多人游戏 |
资源 |
|
按照教程视频完成基本设置。
- 安装 Unity 时，请确保根据您的操作系统包含以下模块：
- Android Build Support
- iOS Build Support
- Mac Build Support (Mono) - 如果您的 PC 运行的是 Windows，请安装
- Windows Build Support (Mono) - 如果您的 PC 运行的是 Mac，请安装
解压下载的ZEPETO Build it Unity Plug-in项目，并在Unity中选择解压后的文件夹将其打开。
双击 World Scene 打开它。
启用顶部的 Multiplayer Server, 直到它变成绿色，然后单击下面的箭头使用您的 Zepeto 帐户登录。单击 Play 进行测试。
再次按 Play 返回编辑模式。
要添加新场景，请转到 Menu > File > New Scene, 选择“Build It”然后单击 Create。
注意
- 新的主题更新文件将应用于您已在开发的世界。
- 如果您想创建一个新世界而不是您正在处理的世界，请下载 ZEPETO Build it Unity Plug-in 文件并解压缩，然后将应用最新主题。
步骤 2: 将其拖拽至ZEPETO Build it Unity Plug-in项目中。
步骤 3: 导入完成后，请关闭并重新打开项目。
按照教程视频放置各种 3D 对象并创建地图。
- 在左侧的Build It Asset Browser中选择一个对象，然后单击地图将其放置。
- 右键单击或按 ESC 键取消选择该对象。
- 使用 search 框按英文关键词查找对象。单击 search 框旁边的 X 可将其重置。
- 调整 Zepeto Scene Settings 中的设置，例如背景颜色、地图亮度和灯光颜色。Reset 按钮可恢复默认设置。
- Top Color: Skybox 渐变的顶部颜色
- Center Color: Skybox 渐变的中心颜色
- Bottom Color: Skybox 渐变底部颜色
- Up Vector: Skybox 渐变的位置
- Exp: Skybox 渐变模糊量
- Ambient Color: Scene 的默认亮度
- Default Light Rotation: Scene 中的默认光照角度
- Light Intensity: 默认灯光亮度
5. 要调整角色控制设置，请选择左侧的 Hierarchy 选项卡中的 Manager, 然后调整右侧的 Inspector 中的值。
- Walk Speed: Zepeto 角色的步行速度（默认值：2）
- Run Speed: Zepeto 角色的奔跑速度（默认值：5）
- Jump Power: Zepeto 角色的跳跃力量（默认值：13）
- Enable Double Jump: 切换双跳功能。
- Double Jump Power: Zepeto 角色的双跳力量（默认值：13）
- Fall Area Position: 低于该高度字符将重置位置（默认值：-200）
ZEPETO Build it Unity Plug-in 提供 utility 对象来创建一个无需编码的充满活力的世界。
通过观看教程视频了解如何使用功能对象，然后将它们应用到您的世界中以创造更具吸引力的体验！
在 Scene 中放置一个 BGM 对象来播放背景音乐（BGM）。每个 Scene 中只能有一个 BGM 对象。
- AudioClip: 在 Inspector 中分配一个音频剪辑（支持 .mp3 或 .wav 格式）。
单击 SFX 对象时会播放特定的声音。将其放置在场景中并在 Inspector 中配置设置。
- AudioClip: 在 Inspector 中分配一个音频剪辑（支持 .mp3 或 .wav 格式）。
- IconPos: 调整图标位置以方便用户互动。
通过输入 Zepeto ID 来创建 NPC。
仅当激活 Play Mode 时，NPC 才会出现。
- Zepeto ID: 输入NPC的账号ID。
- Has Speech Bubble: 靠近 NPC 时会显示对话框。
- Speech Bubble Text: 设置NPC对话框的文本。
单击 interactive 对象可触发特定的角色手势。
- Interaction_bed: 做出躺下的动作。
- Interaction_chair: 做出坐姿。
- Interaction_dance: 做出舞蹈手势。
您可以修改 interactive 对象以应用各种形式：
- Change Animation Clip: 替换应用于 InteractionPoint 子对象的动画剪辑的动画文件，以在交互期间做出不同的手势。
- Is Snap Bone: 角色的位置基于特定骨骼固定。例如，如果骨骼设置为 Foot, 则动画播放时角色的脚将保持在 InteractionPoint 位置。禁用此功能可让角色远离对象。
- Body Bone: 当启用“Is Snap Bone”时，设置角色将锚定到的骨骼。
- 改变对象外观：移除负责外观的子对象，并将其替换为地图上同一位置的另一个对象以改变外观。
- 更改交互图标位置：如果更改对象的外观，请相应调整 IconPos 子对象的位置以与新设计对齐。
一旦点击 teleport 对象，它就会立即将用户移动到设定的目的地。
- Destination Point: 通过移动子 destination 对象来设置目的地。
您可以自定义teleport对象的外观和交互按钮位置，以符合您独特的设计理念。
- 改变对象外观：删除负责外观的子对象并将其替换为地图上同一位置的另一个对象以更新其外观。
- 调整交互图标位置：如果更改对象的外观，请更新 IconPos 子对象的位置以与新设计正确对齐。
点击后会生成一个随机数并将其显示在 Zepeto 聊天窗口中。
- Number Range: 在 Inspector 中设置最小值和最大值。
您可以自定义 roulette 对象的外观和交互按钮位置，以匹配您独特的设计理念。
- 改变对象外观：删除负责外观的子对象并将其替换为地图上同一位置的另一个对象以更新其外观。
- 调整交互图标位置：如果更改对象的外观，请更新 IconPos 子对象的位置以与新设计正确对齐。
单击“Start”对象后显示计时器 UI 并开始计时。单击“Finish”对象后显示成功消息。
您可以自定义timer对象的外观和交互按钮位置，以符合您独特的设计理念。
- 改变对象外观：删除负责外观的子对象并将其替换为地图上同一位置的另一个对象以更新其外观。
- 调整交互图标位置：如果更改对象的外观，请更新 IconPos 子对象的位置以与新设计正确对齐。
Spawn 对象在世界开始时设置 Zepeto 角色的生成点。
- 如果场景中没有 Spawn 对象，ZEPETO 角色将在坐标 x=0, y=0, z=0 处生成。
- 如果存在多个 Spawn 对象，ZEPETO 角色将随机选择其中一个作为其生成位置。
这是跳跃地图中常用的移动平台，可启用多人同步。角色可以登上平台，您可以轻松配置其移动路径和速度。
自动多人同步可确保房间内的所有玩家看到平台以相同的方式移动。
您可以在子对象MovingPlatformManager中配置其属性。
- Sync Type : 同步设置属性。
- Sync : 启用多人同步。
- NoneSync : 禁用同步。
- Tween Type : 定义 DOTween 如何处理来回移动。
- Circulation : 以循环方式移动（例如，1 -> 2 -> 3 -> 4 -> 1 -> 2 -> 3 -> 4）。
- Linear : 沿线性路径来回移动（例如，1 -> 2 -> 3 -> 4 -> 3 -> 2 -> 1）。
- TeleportFirstPoint : 当到达终点时，它会立即传送回起点并重复（例如，1 -> 2 -> 3 -> 4 -> 1（传送））。
- Loop Type : 定义重复行为。
- Repeat : 不断循环。
- JustOneWay : 仅在一个方向运行一次。
- JustOneRoundTrip : 运行一次往返。
- Sync Extrapolation : 计算位置以考虑服务器延迟。
- 默认值： 真的
- Tween Position
- 输入平台应移动的 localPosition 坐标。平台将根据 Tween Type 遵循坐标序列。
- 起点和终点位置至少需要两个点。
- Move Speed : 设置对象的移动速度。
自定义 MovingPlatform 对象的外观
- 改变对象外观：删除负责外观的子对象，并将其替换为同一位置的另一个对象，以创建您独特的设计。
用户进入世界时会显示此弹出窗口。当用户点击弹出窗口内的按钮时，它会自动关闭。
使用弹出窗口介绍您的世界或宣传您的独特活动！
- 重要说明
- 弹出窗口不放置在地面上；它出现在 UI 屏幕区域内，可以在 Game View 中查看。
在 Hierarchy 中选择弹出窗口，并在 Inspector 中调整其属性。您可以在 Play Mode 中查看这些更改。
- Background Image: 将 2D 精灵图像拖到这里来更改背景。
- Message: 编辑消息文本。
- Message Color: 调整消息文本的颜色。
- Message Shadow: 切换消息文本的阴影效果为打开或关闭。
- Button Title: 更改按钮上的文本。
使用 ZEPETO Build it Unity Plug-in，您可以使您的世界货币化！按照教程视频添加货币化元素。
广告功能以传送对象的形式实现，便于集成。主要功能涉及观看广告后执行特定操作的脚本。ZEPETO Build it Unity Plug-in 利用了此传送设计，因此请记住这一点。
- Destination Point : 通过将子对象 destination 移动到所需位置来设置目标点。
自定义广告传送对象的外观和交互按钮位置。
- 如果您熟悉 Zepeto Scripting，请打开 AdvertisementController.ts 文件来自定义点击广告按钮时触发的各种事件。这可以让您的世界拥有更加个性化的互动和货币化策略。
将您的自定义服装 Item ID 分配给 mannequin 对象，以允许进入您的世界的用户购买所显示的服装。
人体模型仅在 Play Mode 中出现。
- 类型
- Simple: 仅显示交互图标，不显示人体模型。您可能需要添加自定义子对象以改善外观。
- Zepeto Model: 显示穿着服装的默认人体模型。
- Zepeto Template: 输入 Zepeto ID 以显示带有服装的角色模型。
- Pose: 调整人体模型的姿势。
- Ids: 输入您创建的服装的 Item ID。
您还可以通过在礼物对象上设置 Item ID 来允许用户向世界上的其他玩家赠送服装。
物品所有者可以通过赠送功能赚取收入。
请注意，赠送功能只能在移动设备上测试。
- Item ID: 输入要赠送的物品的ID。
自定义 Gift 对象外观和交互按钮位置。
- 改变对象外观：删除负责外观的子对象并将其替换为同一位置的另一个对象，以匹配您的独特概念。
- 调整交互图标位置：如果对象的外观发生变化，则调整 IconPos 子对象的位置以与新设计对齐。
可以放置在世界中来玩简单迷你游戏的对象。
- 基本操作
- 当您按下放置的对象时，该对象会自动运行。
- 如果您在Yonghee角色看着您时移动，激光就会射出，您就会摔倒。只是有一个下落的动作。
- Yonghee角色回头看的时间可以在Inspector中设置。
- Inspector描述
- Paused: 打开/关闭Yonghee的动作。如果你想把它当作一个没有函数的对象来使用，请将其设置为暂停。
- Min Counting Time: Yonghee回望的最短时间。
- Max Counting Time: Yonghee回头看的时间最长。
分别计算 O 和 X 区域中站立人数的对象。
放置在地板上后即可立即使用，无需更改任何设置。
- O、X 层的Collider区域是识别计数的区域。您可以通过调整这些区域的大小来修改它们。
允许您使用倒计时的显示对象。
默认倒计时时间设置为五分钟。
这个值可以在Inspector中改变。
- Inspector描述
- MaxValue: 倒计时开始时间（以秒为单位）
- MinValue: 倒计时结束时间（以秒为单位）
- Interval: 倒计时间隔（以秒为单位）
踩踏或触摸时就会消失的物体。
尝试将其用作跳跃地图中的障碍物。
- Inspector描述
- Is Breakable: 打开/关闭触摸时中断的属性。以下属性仅在Is Breakable启用时才起作用。
- Auto Reset Delay: 被触摸后，对象会在Auto Reset Delay中设置的时间后自动重新生成。
- Has Auto Reset: 如果您不希望对象消失，请关闭Has Auto Reset。
Q. 我看不到从 Unity Asset Store 下载的包。 A. 下载资源后，重新启动 Unity 并检查 Windows > Package Manager > Package: My Assets 窗口。
Q. 该包无法构建。 A. 确保安装了所有必需的 Unity 2022 模块。请参阅升级到 Unity 2022 的指南。在升级到 Unity 2022 版本后的故障排除
Q. 我无法登录 Unity。 A. 检查您的ZEPETO账户是否为临时账户。您需要注册ZEPETO帐户才能创建世界。
Q. 我需要手动查找并设置 Moving Platform 的坐标吗？ A. 是的。将对象移动到所需位置，检查坐标，然后相应地更新 Tween Position 值。
Q. 我点击了 Publish 按钮，但找不到生成的 .zepetopackage 文件。 A. .zepetopackage 文件在项目文件夹 > Build > ZEPETO.Script文件夹中创建。
Q. 我需要一个新的 ZEPETO Build it Unity Plug-in 来创建一个新世界吗？ A. 是的。使用最新的 ZEPETO Build it Unity Plug-in ZIP 文件创建新的项目文件夹。
Q. 使用 ZEPETO Build it Unity Plug-in 创建世界时是否有大小限制？ A. .zepetopackage 文件大小不得超过 1GB。为了进行优化，请确保 Runtime Profiler 中显示的 Allocated Memory 不超过 550MB。 运行时分析器
Q.我在 Play Mode 中看不到 ZEPETO 角色。 A. 检查顶部的 Start Multiplay Server 按钮是否呈绿色亮起.
Q. 我无法在 Scene 中选择对象，或者选择了不同的对象。 A. Scene 中重叠的对象可能会导致选择问题。尝试从 Hierarchy 选项卡中选择所需的对象。
Q. 如何将游戏画面切换为竖屏模式？ A. 使用 ZEPETO Build it Unity Plug-in 创建的世界针对横向模式进行了优化。对纵向模式的支持即将推出。请继续关注！
Q. The QR code generated in Unity doesn’t work for testing. A. Unity编辑器中的二维码测试受用户网络环境的影响很大。为了更顺利地进行移动测试，请将 .zepetopackage 文件上传到 ZEPETO Studio 并使用其中生成的二维码。
Q. 我添加的 Scene 没有出现，而是显示了不同的屏幕。 A. 如果所需的场景未在 Build Settings 中注册，则会发生这种情况。释放你的世界
- 在开发过程中定期以 Play Mode 播放您的世界。这有助于检查适当的比例和意外错误。
- Build It Asset Browser 中的 Asset 可以替换其材质。有些资产甚至允许部分材料更换。
- 示例：对于cafe_furniture_worktable1和cafe_furniture_worktable2，您只能更改桌面的材质。
- 创建新世界后，进入Edit > Project Settings > Zepeto Service并确保该世界与 ZEPETO Studio 中创建的世界链接。否则可能会导致发布过程中出现错误。
- ZEPETO Build it Unity Plug-in 的知识产权（包括版权）归“NAVER Z”及其关联公司所有。欲了解更多信息，请参阅以下链接。[ZEPETO World SDK 许可和条款]
- ZEPETO Build it Unity Plug-in 仅在 ZEPETO World 内免费提供。严禁在 ZEPETO World 平台之外使用此插件。
- 通过 ZEPETO Build it Unity Plug-in 提交世界供审核时，如果与之前发布的世界相似，审核可能会被拒绝。因此，建议更改场景内的背景和对象等资源。
