[(English Version) NTU COOL Subtitle Generator - User Guide](https://hackmd.io/@leyunn/Hkcl4xeYn)

**[2023-12-8 更新] 2.1版本已上線，新增下載.txt逐字稿功能，點擊「下載字幕檔」即可使用。**

[\*\*2023-10-14 更新\*\*] 安裝[環境開啟執行檔](https://hackmd.io/yD9gREvpSx-A4DThZ53Tzw) (支援Mac, Windows系統)，即可點擊開啟設定完成的瀏覽器，省略安裝第一步驟。

NTU COOL 字幕產生器 (Beta) 是一個 Chrome 瀏覽器擴充功能，為 NTU COOL 語音辨識字幕功能的測試版。
只需要將此擴充功能安裝在Chrome瀏覽器上，即可在NTU COOL網站中體驗字幕功能。
目前支援辨識中文、英文的影片，並可將產生的字幕自動翻譯為英文字幕。
本擴充功能**並非**由NTU COOL團隊開發，若有使用上的問題請使用下方的[問題回報表單](#0.-回報問題)。

[toc]

## 0. 回報問題

[問題回報表單](https://docs.google.com/forms/d/e/1FAIpQLSc5jnx33SVOHS7drPtKGeQSXkY2r6QArIXSocsz31rIzuDyrw/viewform?usp=sf_link)
## 1. 如何安裝擴充功能？

### 步驟ㄧ：關閉瀏覽器安全性檢查功能
**[重要] 在開始之前，請先詳閱 [關閉瀏覽器安全性檢查功能後的風險與建議 - 為甚麼需要關閉此功能？](#8.-關閉瀏覽器安全性檢查功能後的風險與建議)**

以下是在不同系統下開啟「一個安全性檢查功能關閉的Chrome瀏覽器視窗」的方法：
#### Mac OS
1. 開啟終端機。([如何開啟Mac終端機?](https://support.apple.com/zh-tw/guide/terminal/apd5265185d-f365-44cb-8b09-71a064a42125/mac))
2. 在終端機內輸入指令：`open -na Google\ Chrome --args --user-data-dir=/Applications/Chrome-CoolExtension --disable-web-security --disable-site-isolation-trials`
3. 按下Enter，彈出Chrome視窗即為開啟成功。
**(由於此視窗的安全風險較高，請不要在此視窗瀏覽其他網頁)**

開啟成功後，可以右鍵點擊新開啟的Chrome，將新開啟的Chrome釘選在Dock上，下次即可直接點擊開啟

#### Windows
1. 開啟命令行。([如何開啟Window命令行?](https://support.kaspersky.com/common/windows/14637#block0))
2. 在命令行內輸入指令：`"C:\Program Files\Google\Chrome\Application\chrome.exe" --disable-web-security --disable-site-isolation-trials --user-data-dir=%LOCALAPPDATA%\Google\Chrome-CoolExtension`
3. 按下Enter，彈出Chrome視窗即為開啟成功。
**(由於此視窗的安全風險較高，請不要在此視窗瀏覽其他網頁)**

開啟成功後，可以右鍵點擊新開啟的Chrome，將新開啟的Chrome釘選在Dock上，下次即可直接點擊開啟

> 若出現`系統找不到指定路徑`的錯誤，請將`C:\Program Files\` 改為 `C:\Program Files （x86)\`再嘗試一次。
> 若仍然找不到檔案，可前往`Chrome://version`查看「可執行檔的路徑」，並修改成對應的Chrome路徑。

#### Linux
1. 開啟終端機。
2. 在終端機內輸入指令：`google-chrome --disable-web-security --disable-site-isolation-trials --user-data-dir=/tmp/Chrome-CoolExtension`
3. 按下Enter，彈出Chrome視窗即為開啟成功。
**(由於此視窗的安全風險較高，請不要在此視窗瀏覽其他網頁)**

成功開啟的畫面，在視窗上緣應該會出現「安全性檢查功能已被關閉的提醒」。

### 步驟二：從chrome 線上應用程式商店下載擴充功能
1. 在剛剛開啟的Chrome視窗中前往此網址：https://chrome.google.com/webstore/detail/ntu-cool-%E5%AD%97%E5%B9%95%E7%94%A2%E7%94%9F%E5%99%A8/docghmaodkaieihebenpieblmcfcoppo
2. 點選「加到Chrome」。


3. 點選「新增擴充功能」。


4. 加入完成後，點擊右上角的擴充功能圖示，並點擊釘子圖示將「NTU COOL 字幕產生器」釘選。


若在左側出現一個NTU COOL的圖示即為成功。


## 2. 如何開啟擴充功能？
> 注意事項：本產生器目前不支援來源為Youtube的影片
1. 在安裝好擴充功能的視窗中，開啟一個想希望有字幕的NTU COOL影片網頁。


2. 點擊右上角的NTU COOL圖示，會彈出一個視窗：


3. 當彈出視窗加載完畢後，若畫面為下列畫面之一，即為正常啟動：

1. 出現開始辨識字幕的按鈕，代表這個影片的字幕還未被產生過。


2. 出現字幕開關，代表這個影片已經有字幕可以使用了，只需要播放影片就會自動出現字幕。


3. 其他若出現「[等待處理](#3.-如何產生影片字幕？)」或是「[處理中](#3.-如何產生影片字幕？)」的畫面，代表已經有其他人申請此影片的辨識，只需耐心等待辨識完成，即可使用字幕。

> 如果出現錯誤畫面，可能的原因包含：影片來源為Youtube(不支援字幕)、或是瀏覽器沒有按照[上方教學的方式](#步驟ㄧ：關閉瀏覽器安全性檢查功能)開啟等。

## 3. 如何產生影片字幕？
1. 點擊「開始辨識字幕」。


2. 出現「等待處理」或是「處理中」的畫面，代表送出成功。


影片處理時長約為影片長度的**三分之一**。

> 如果出現錯誤畫面，可能的原因包含：影片是今日才發布、影片近期有異動、或是一分鐘內送出太多辨識請求等，會在畫面中提示下一步該怎麼做。

## 4. 怎麼樣算是辨識完成？
點擊右上角的NTU COOL圖示後，若字幕開關，代表辨識已經完成並且可以使用，只需要播放影片就會自動出現字幕。

## 5. 如何下載字幕檔？
在已辨識完成的影片頁面中，點擊 NTU COOL 字幕產生器 >下載字幕檔。
將下載後的檔案解壓縮，即可看到字幕的原文、英文翻譯 SRT 檔。


## 6. 如何切換字幕語言？
在已辨識完成的影片頁面中，點擊 NTU COOL 字幕產生器 > 「字幕語言」下拉選單，可選擇「影片語言」或是自動翻譯的「英文」字幕。

> 翻譯的字幕會在影片的字幕被產生之後的2天內被產生。

## 7. 其他常見問題

### a. 如果彈出視窗顯示「瀏覽器安全設定未關閉」怎麼辦？
請參考[「關閉瀏覽器安全性檢查功能教學」](#步驟ㄧ：關閉瀏覽器安全性檢查功能)中所述的步驟開啟Chrome。

### b. 如果彈出視窗一直顯示「等待處理...」怎麼辦？
由於辨識字幕服務的資源有限，請求較多時可能會需要等待一個小時以上（一部影片的處理時長約影片長度的三分之一），若前方等待的影片眾多，建議隔天再查看此影片。

### c. 如何重新載入擴充功能？
若視窗一直顯示「載入錯誤」或是有其他理由希望重新啟動本擴充功能，可以按照下列步驟：
1. 前往網址 `chrome://extensions`，在裡面找到「NTU COOL 字幕產生器」。
2. 將開關關閉後再開啟一次即可。


### d. 如何切換此擴充功能介面的語言？
本擴充功能的目前只支援英文及中文介面，會根據使用者瀏覽器的語言切換，預設為英文。 [如何更改瀏覽器語言？](https://support.google.com/chrome/answer/173424?hl=zh-Hant&co=GENIE.Platform%3DDesktop#zippy=)

### e. 我可以在哪些瀏覽器上使用這個字幕產生器？
目前這個擴充功能只支援Chrome瀏覽器。

### f. 我可以在哪些裝置上使用這個字幕產生器？
此擴充功能支援Chrome網頁版，包含Mac OS, Windows, Linux等。但無法在行動裝置上使用，如Andriod, iOS等。

### g. 可以在影片管理功能中使用 NTU COOL 字幕產生器嗎？
否，因影片管理頁面有權限限制，目前只有被加入「課程內容」頁面的影片可以使用此擴充功能。
### h. 字幕辨識有錯，我可以修改字幕嗎？
否，下載的字幕檔僅供留存用，無法修改後再自行上傳。 若老師希望影片中有正確的字幕，建議下載 .srt 字幕檔後自行修正，再使用影片剪輯軟體將字幕加入影片檔案中。
### i. 我可以在其他網站或影片使用這個產生器嗎？
否，此產生器是為了幫助台大學生的影片學習，因此只供台大課程的影片使用，由於運算資源有限，無法開放給非台大課程使用，非常抱歉。

## 8. 關閉瀏覽器安全性檢查功能後的風險與建議
[回到安裝教學](#1.-如何安裝擴充功能？)

### a. 我們的建議
為保護使用者的安全，我們建議的方式是**開啟一個專門用來使用此擴充功能的Chrome瀏覽器視窗，且不要在此視窗瀏覽其他網頁**。

### b. 瀏覽器安全性檢查功能是什麼？
在Chrome瀏覽器上預設都會開啟這個「安全性檢查功能」，最主要的目的為實施**同源策略(Same Origin Policy)**，也就是**限制不同來源的網站的程式碼不能互相干擾或操控對方的資料**，防止惡意網站透過腳本等方式取得其他來源上的敏感資訊，以保護使用者的隱私和安全。
### c. 為什麼需要關閉才能使用此擴充功能？
**NTU COOL中的「影片」並沒有直接存在NTU COOL網站裡，而是嵌入了另一個來源(Cross Origin)的「影片播放功能」**。因此，在NTU COOL網站附加擴充功能，也沒辦法對影片進行操作（根據同源策略），除非影片來源端開放這方面的操作。 由於此擴充功能僅為NTU COOL 語音辨識字幕功能的測試版，**為了最低限度的改變COOL的系統**，才使用此方案。
### d. 關閉後的風險
使用沒有開啟「安全性檢查功能」的瀏覽器瀏覽來源不明的網站時，可能會遇到以下風險：
1. **跨站腳本攻擊（XSS）**：你可能在瀏覽網站時遇到惡意網站，它能夠在你的瀏覽器上執行腳本並竊取你的個人資料，如密碼、信用卡號等。此外，它也可以修改網站的內容，讓你誤以為你正在與合法的網站互動，但實際上卻是惡意網站。
2. **跨站請求偽造（CSRF）**：你可能會收到一封看似合法的郵件或點擊一個表面上安全的連結，但卻將你引導到一個惡意網站。這個網站將利用你的身份進行非法操作，如更改你的密碼、進行資金轉帳等。
3. **敏感資料外洩**：網站A可能能夠直接訪問網站B上的敏感資料，例如你的個人資訊、帳戶細節等。這增加了你的敏感資料被洩露的風險，因為一個被入侵的網站可能導致其他相關網站的資料也被攻擊者獲取。
4. **網站篡改**：惡意網站能夠修改其他網站的內容。當你訪問一個被入侵的網站時，惡意網站可以更改該網站的內容，包括替換圖片、修改文字、插入廣告等。這樣一來，你可能被引導到其他惡意網站，或者受到虛假信息的誘導。

由於上述風險，我們建議的方式是**開啟一個專門用來使用此擴充功能的Chrome瀏覽器視窗，且不要在此視窗瀏覽其他網頁**。