---
title: 研討會串接指南
GA: UA-123104581-4
tags: Document
---

# Android / iOS 功能設定
## Portal
https://portal.opass.app

## 說明

在 Android 及 iOS 功能列表都是從網路讀取產生，請根據 Portal 說明，將需要的功能填寫上去並產生 json 後發送 PR

feature 為 webview 等相關頁面，建議實做 query tring 判斷流量來自 app 的功能（ex: ?mode=app），將 navigation bar 等藏起來，在 App 內有較佳閱讀效果

## 參考畫面

## 參考 json
https://portal.opass.app/events/COSCUP_2019/

# 常見功能及說明（請根據大會需求挑選）

## OPass 內建特殊功能
- [快速通關](#快速通關)
- [我的票券](#我的票券)
- [議程](#議程)
- [大會公告](#大會公告)
- [WiFi](#WiFi)

## OPass 內建 icon，功能為開啟第三方應用程式或嵌入網頁
- Telegram
- IRC
- 大地遊戲
- 會場地圖
- 贊助單位
- 工作人員

## 自定義 icon 並嵌入網頁
feature 請選擇 webview，並提供 icon url

## 快速通關
### 參考畫面

### 情境設定
如上圖，報到、迎賓袋、午餐等，在 OPass 我們稱呼為情境（scenario），根據現場身份別（請注意，售票系統的票種不一定等於現場身份別，請根據大會需求定義現場的身份別）可以設定不同的情境。

情境設定的倒數非常重要！如果為 0，表示不會進入倒數畫面直接使用掉，通常用於報到統計人數及便當；若是大於 0，則會進入倒數畫面，並顯示更多設定時有填寫的連帶資料，供工作人員查驗。

設定檔通常可以公開，過去 conference 會讓不同身份別處理的人員自行撰寫設定檔，大家都放到 GitHub co-work 參考下方範例 repo，通常現場身份別分為與會者、講者、工作人員三種，但是可以根據需求變更。

**情境的開立請務必思考好整理報到動線及流程如何運作**，參考畫面的報到及迎賓袋分開，其考量為希望與會者進入會場就可以自行點擊報到，不需經由工作人員檢查，直到他需要領取迎賓袋及識別證時才需要到特定地點點擊卡片進入倒數畫面供工作人員檢查（他可以在會場外盡情聊天不來領東西也沒關係）；以中研院為例，會派人在二三樓放置立牌或是人力提醒與會者點擊報到，迎賓袋領取處則放至於四樓，讓與會者領取迎賓袋的過程中就有機會路過贊助攤位。

關於更多欄位怎麼使用請參考 source code
https://github.com/CCIP-App/CCIP-Server/blob/master/app/ccip.py#L167-L189

#### 範例 repo
https://github.com/sitcon-tw/SITCON2019-CCIP-config

#### 範例 scenario
https://github.com/CCIP-App/CCIP-Server/blob/master/app/scenario-sample.json

### 匯入資料
請準備好相關身份別人等的匯入資料，提供 csv 檔案，token 為必要欄位，通常為售票系統的 QR Code 識別碼，或是自行產生；若情境設定有需要參照相關欄位也請一併提供

import.py 通常需要被修改以吻合提供資料的欄位名稱
https://github.com/CCIP-App/CCIP-Server/blob/master/app/import.py

#### 範例資料
https://github.com/CCIP-App/CCIP-Server/blob/master/app/reg-sample.csv

### 客製化信件
OPass 的啟動連結類似以下網址，每位與會者都需要收到不同的連結，請務必有發送客製化信件的解決方案（ex: SendGrid, Mailchimp, Mailgun）

與你的 server 架設負責人聯繫取得 event_id

https://opass.app/r/<event_id>/<token>

## 我的票券
### 說明
登入或顯示已儲存的 QR Code，透過快速通關功能所設定的 url 進行身份驗證，驗證成功即儲存該 QR Code

### 範例畫面（Android）
#### 未登入狀態
#### 登入方式選擇
#### 登入後

## 議程
### Repo
https://github.com/CCIP-App/schedule-json-generator

### 說明
請閱讀 repo README，產生後的 json 放到可公開存取有 url 的地方，將網址填上 portal

## 大會公告
回傳以下格式 json 即可呈現

[
  {
    datetime: 1596266033, // unix timestamp
    msg_en: "Last Call for Lightning Talks! The final list will be drawn soon. Submit your COSCUP Lightning Talks before 15:30pm at TR 2F! Don’t miss the chance to present your project, idea, or experience in 5 minutes!",
    msg_zh: "閃電講今日報名到 15:30 截止！請至 TR大樓 2F 服務台報名，本次採抽籤制，有投有機會，快把你的好點子秀出來吧！！",
    uri: "" // optional
  },
  ...
]

### 範例畫面

## WiFi
### 說明
提供使用者大會 WiFi 的 SSID 及密碼儲存至系統

### 範例畫面

## 大地遊戲
### 說明
OPass 有預設 icon，也有現成的大地遊戲專案可以使用，但你也可以自行撰寫大地遊戲

請參考[大地遊戲支援功能](/jk3Jqp2eS5uWqKmgE7RoUA)文件，選擇使用的大地遊戲模式，參考 repo 的 README 完成相關檔案設定，並 fork repo 或是 clone 下來根據 CI 流程 build 即可完成佈署

### Repo
https://github.com/CCIP-App/CCIP-Puzzle-Chocolate

### 攤位端連結

https://<your_host_name>/<mode>?token=<delivery-permission-token>

#### mode 參考
https://github.com/CCIP-App/CCIP-Puzzle-Chocolate/blob/b776726001431fc1a1ed587a0e293c52b42cc4f0/src/router.js#L17-L21

#### 攤位端 token 設定
https://github.com/CCIP-App/CCIP-Server/blob/master/app/delivery-permission-sample.json