---
title: 'VoTT 安裝流程與建立專案(Windows 10) '
disqus: hackmd
---

[TOC]
## Windows 10 VoTT 安裝流程與建立專案

### 1. 安裝相關套件 Node.js

> (1) 先至 ~~https://nodejs.org/zh-tw/download/~~ 下載Node.js安裝包

:::warning
由於版本問題,請至[此連結](https://nodejs.org/download/release/v12.19.0/)下載12版本
node-v12.19.0-x64.msi
:::

> (2) 安裝完成後，打開cmd

輸入
>node --version
 v12.19.0   
>npm --version
 6.14.8

> (3)若有顯示版本代表安裝成功
> (4)若無，則必須新增Node.js的路徑到PATH中，新增完成後再一次檢查是否有安裝成功

### 2. 下載 VoTT source code

:::warning
20201101更新下載source code方式
:::
請依照[此文件](https://hackmd.io/@NTUTVOTT/SkPb4Z7Lv)安裝相關套件,並將source code安裝在D:

打開Cygwin64 Terminal
$ cd d:
$ mkdir VoTT
$ cd VoTT
若沒有申請KEY在遠端GITHUB,用HTTPS下載:
$ ~/bin/repo init -u https://github.com/masteree108/VoTT_NTUT_WIN10_repo.git -b master

若已經有申請KEY在遠端GITHUB,請選用SSH下載:
$ ~/bin/repo init -u [e-mail]:masteree108/VoTT_NTUT_WIN10_repo.git -b master

$ 現在VoTT的資料夾只有.repo還沒有各別的專案資料夾
$ ls -a 可看到只有.repo資料夾

更新來源(等同於從遠端下載)
$ ~/bin/repo sync 

指定連結到遠端的主分支
$ ~/bin/repo start master --all

> ~~(1) 為了方便管理整個專案,請先至D:開一個資料夾後開啟cmd進入到此資料夾中~~

* 註: 請選擇安裝位置,注意此份安裝文件可能會與您安裝的位置不同

> ~~(2) 下載 source code*~~

git clone https://github.com/masteree108/VoTT_NTUT_WIN10.git 

~~* 註1: 若無安裝Git版本控制，請先安裝，可以照 https://progressbar.tw/posts/1 此網站步驟安裝~~

* 註2: 此包 source code 是基於在 [microsoft/VoTT](https://github.com/microsoft/VoTT/) 2.2.0版本上開發新功能

### 3. 下載 VSCode
>(1)請至 https://code.visualstudio.com/ 下載VSCode安裝檔

### 4. 建立專案

> （1）請先至D:建立專案資料夾

cd d:
cd VoTT
mkdir Drone_Project
cd Drone_Project
mkdir -p Drone_Target/001    //用來放置專案的.vott檔案*
mkdir -p Drone_Source/001    //用來放置來源影片*

* 註：Drone_001是代表影片代號名稱,每個影片都會個別建立自己的資料夾以免混亂,
若有002影片就分別在Drone_Target與Drone_Source建立002資料夾,依此類推

> (2) 執行VoTT

1. 開啟vscode
2. 按下ctrl+`開啟cmd
3. 輸入npm ci (若無錯誤請跳至第四步驟)

    3-1. 依照之前的經驗 基本上是node version的問題
         輸入 node --version 確認自己的版本
         EX: 若是12.**** 
             輸入 npm install node-sass@4.12.0
             輸入 vim package.json
             將node-sass版本改到4.12.0
             
    3-2. 若還是無法可以試著安裝electron-builder
         輸入 npm install electron-builder -g
         
    3-3. 若還是有錯，請先看錯誤並找Google大神

4. 輸入npm start

> (3) 新建專案設定（security token、名稱、專案路徑、來源路徑等)
* 關於 security token

引述官方文件如下

#### NOTE: Project files can be shared among multiple people. In order to share sensitive project settings, all parties must

為了讓專案讓LAB的同學共同使用, security token 使用先前研究留下來的key

    Name : NTUTDrone Token
    Key : qITjd1Rj6hFqC7uB0OGxPKYVxIFSdcMrprQAMS5rEhc=

點選左下角的齒輪,輸入之前的 security token
* 在VoTT內點選 New Project

* 專案名稱：NTUT_Drone


* Security Token: 選擇 "**4. 關於 security token**" 所建立的設定,
下拉即可找到 **NTUTDrone Token** 選項

* Source Connection
選擇右邊的Add Connection會進入Connection Settings畫面
按照下圖選擇
Provider 選擇 Local File System
Local File System 選擇剛剛在 "**（1）建立一個專案資料夾**" 建立的source資料夾 Drone_Source/001
按下Save Connection回到 Project Settings

* 注意: 在此資料夾中必須含有要使用的影片


選擇剛剛設定的資料夾

* Target Connection
選擇右邊的Add Connection會進入Connection Settings畫面
按照下圖選擇
**輸入Display Name: Drone_Target_001 (00X請依據影片名稱創立)**
Provider 選擇 Local File System
Local File System 選擇剛剛在 "**（1）建立一個專案資料夾**" 建立的target資料夾 Drone_Target/001
按下Save Connection回到 Project Settings


選擇剛剛設定的資料夾

* Video Settings 使用預設的15,下圖為整個專案設定,按下 Save Project 按鈕完成新建專案設定

* 完成後會看到的專案畫面


### 5. 載入專案
> 選擇Open Local Project, 找到剛剛在"**（1）建立一個專案資料夾**" 建立的target資料夾 Drone_Target/001 ,可看到NTUT_Drone.vott



### 6. 匯出專案
> (1) 匯出專案設定
* 這邊統一採匯出csv與json格式,請專案負責人這兩種格式都必須要匯出!!
Asset State 選擇 Only tagged Assets
另外取消include Images選項
1. 匯出 CSV

2. 匯出 JSON

> (2) 匯出專案範例
* 若是標注完成,可按下右上角匯出按鈕 


！！請注意,csv格式會匯出在Drone_Target/001資料夾！！

！！另外請在更改一次匯出設定,在匯出JSON檔案！！

！！**請再次確認這兩種格式必須都要匯出**,否則期末無法算出誰標的最多,攸關分數很重要！！

###### tags: `setup`, `VoTT`