---
# System prepended metadata

title: 工具-线下活動製作文檔

---

# 工具-线下活動製作文檔

目的: 方便新人能快速使用工具製作線下活動

## Develop
常用工具組件，日常使用技巧等

### URL
- sta: https://event-server-sta.17app.co/eventory/campaign
- production: https://event-server.17app.co/eventory/campaign

### 常用測試參數
```
测试地址：
sta：https://sta-event.17.live/{ID}-{CodeName}
production：https://event.17.live/{ID}-{CodeName}
```
- dad.now 設置當前時間，如：?dad.now=2021-06-01 12:00:00
- auto 讓dad.now設置的時間可以自動計時，如：?dad.now=2021-06-01 12:00:00&auto
### 創建新的Event
- Event Type：event類型，一般選event
- Display Name：要顯示的名稱
- Code Name：將用於URL顯示
- Default Locale：一般選zh_TW或ja
- Regions：留空即可
- Start Time：活動開始時間
- End Time：活動結束時間
- Scope：一般選Medium
- Cost：留空即可
- Corporation：一般選17Media
- Department：一般選TW-Event或JP-Event
- Tags：根據活動選擇
- Display Name：留空即可
- Banner URL：留空即可
- Sticker URL：留空即可
### 常用的組件及說明
> 所有組件都可以拖拽到視圖，也可以使用複製功能複製到粘貼板並進行粘貼操作
- Page `頁面`
    - props
        - text：頁面標題
    - default：頁面寬度高度，字體，padding等設置
    - background：頁面背景設置
    - global：自定義style，建議導入字體及滾動條樣式在這裡定義
- Switch `頁面切換`
    - props
        - default path: 打開URL進入的router
- Route `路由`
    - props
        - path: 路由地址
        - hotkey：快捷鍵
- LayoutBlock `佈局`
    - content: 對齊方式設置
    - basis：寬高及佈局設置
    - font：字體設置
    - background：背景設置
    - margin
    - pading
    - custom：自定義style
- HorizontalLayout `水平佈局，一般結合LayoutBlock使用`
    - basis：寬高
    - background：背景設置
- VerticalLayout `垂直佈局，一般結合LayoutBlock使用`
    - basis：寬高
    - background：背景設置
- Text `文本`
    - props
        - text：文本
    - default：文字設置
- Countdown `計時器`
    - props
        - start time：開始時間
        - end time：結束時間
        - day：天顯示的文本，一般設為空即可
        - plural day：複數天顯示的文本，一般設為空即可
        - has not begun：還沒開始顯示的文本，一般設為00:00
        - has ended：結束後顯示的文本，一般設為00:00
        - counting：計時顯示的變量，一般為{1}{2}
        - counting format：計時顯示的格式，一般為mm:ss，如果活動時間超過1小時，我們需要顯示小時數避免出現歧義，這時應該設置為: H:mm:ss
    - default：字體及自定義style
- SumOfLeaderboard `榜單總和`
    - props
        - use fetcher：指定榜單Container ID
        - format：顯示文本格式，如：{0}票
    - font：字體設置
    - margin
    - padding
    - default：自定義style
- FlexLeaderboard `榜單列表`
    - props
        - fetcher：指定榜單Container ID
        - min rank：顯示的最小排名，0表示不限制
        - max rank：顯示的最大排名，0表示不限制
        - bonus fetcher：指定bonus的Container ID
    - default：自定義style
- FlexLeaderboard.Item `榜單item數據`
    - props
        - rank：顯示的最大排名，0表示不限制
        - score：顯示的最小分值，空表示不限制
        - unit：分值單位，如：票，它等同於{0} 票
        - bonus unit：bonus單位，如：bonus，它等同於{0} bonus
        - icon：顯示圖標
        - rank image：自定義排名圖片
    - wrapper：背景設置及自定義style
    - rank：榜單排名顯示相關設置
    - avatar：榜單頭像顯示相關設置
    - icon：icon顏色設置
    - content：自定義style
    - openId：用戶名顯示相關設置
    - score：分值顯示相關設置
    - bonus：bonus顯示相關設置

### 常量的使用
> 目前開發工具中為我們提供了兩種常量：Translations和Color
- Translations 使用歎號前綴，比如我們在Translations中創建了一個新的常量"TEST"，我們將使用"!TEST"來調用它，我們可能需要顯示字符串"!TEST"而不是使用TEST常量，這時我們需要在前面再添加一個歎號："!!TEST"
- Color 使用@color.前綴，比如我們在Color中創建了一個新的常量"test"，我們將使用"@color.test"來調用它，我們可能只需要顯示字符串"@color.test"，同樣的，我們需要在前面添加一個歎號："!@color.test"

### 日常使用技巧
- 素材上傳：為了避免兩次上傳，在製作的時候可以提前在production中創建event，將素材上傳到production，sta中直接使用素材url
- 製作視圖分為Viewport和Blueprint兩種模式，sta製作完成並通過測試後，需要同步到production，此時我們可以切換到Blueprint並複製源碼，粘貼源碼到production
- PS：複製源碼僅能複製layout，圖片，常量，Container ID等不會被複製，需要手動在production中重新創建
