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

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

## 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中重新創建