easy qr scan bot

@easyqrscanbot - Telegram 二維碼掃描器 - 迷你應用程式

使用 Telegram 輕鬆掃描二維碼！

該儲存庫包含 @easyqrscanbot 的程式碼，這是一個用於掃描二維碼的 Telegram Mini 應用程式。

如何使用二維碼掃描儀

確保您已更新 Telegram 應用程序，Telegram API 的最低版本要求是6.9 。

1. 在 Telegram 上搜尋@easyqrscanbot並發起私人聊天。
2. 點選左下角的選單按鈕（ Scan QR ）。

3. 開始掃描二維碼！

相容性

Telegram API 版本高於6.9的 Telegram 智慧型手機用戶端（Android 和 iOS）支援 QR 碼掃描器。不幸的是，QR 掃描在 Telegram Web 用戶端上不可用。但是，您仍然可以在 Web 用戶端上存取小型應用程式並查看掃描記錄。

關於項目

此專案示範如何使用 Vue 等現代 JavaScript 框架建立 Telegram Mini 應用程式。它還示範如何利用 Telegram API 6.9 版中引入的最新功能，包括：

• QR 圖碼掃描
• 利用 Telegram Cloud Storage，這是一個可透過迷你應用程式存取的鍵值資料庫

該專案代表一個純 Vue 前端應用程序，它使用 Telegram 雲端儲存後端來儲存所獲取的掃描。

小程式部署

部署流程使用 GitHub Actions 完全自動化。每次推送到master分支時，都會自動建立迷你應用程式並將其部署到關聯的 GitHub Pages 網站。

在此處訪問迷你應用程式：迷你應用程式連結。

對於開發商

要開始該項目，請按照下列步驟操作：

1. 克隆儲存庫：

 git clone https://github.com/MBoretto/easy-qr-scan-bot.git
cd easy-qr-scan-bot

2. 安裝依賴項：

 npm install

3. 建構專案：

 npm run build

若要執行程式碼檢查，請使用以下命令：

 npm run lint

快樂編碼！

部署您自己的小應用程式

在開始之前，請確保您有一個 Telegram 機器人。如果您還沒有，您可以使用此 Telegram 指南建立一個。

克隆和部署

如果您想部署自己的小程序，請按照以下步驟操作：

1. 克隆這個儲存庫。

2. 透過前往Settings -> Pages -> 選擇GitHub Actions作為來源，為您的儲存庫啟用 GitHub Pages。 GitHub 會自動將小型應用程式部署到與您的儲存庫關聯的 GitHub Pages 上。

您也可以選擇使用任何支援https://託管服務來部署您的小型應用程式。

使用 Telegram Bot 選單啟動迷你應用程式

這是啟動迷你應用程式最簡單的方法，因為它只需要您設定一次 Telegram Bot 選單。以下是將迷你應用程式連結到機器人選單的步驟：

1. 打開 @BotFather 機器人並發送命令/mybots 。
2. 選擇您要連結到小應用程式的機器人：

3. 按下“機器人設定”：

4. 按下“選單按鈕”：

5. 按下“配置選單按鈕”：

6. 插入迷你應用程式的 URL 並指定選單按鈕的名稱。

現在，您可以從 Telegram Bot 選單啟動您的迷你應用程式。

使用 Telegram Bot 命令啟動迷你應用程式

此方法在開發階段很有用，可讓您為小型應用程式指定不同的 URL，而無需重新配置 Telegram Bot 選單。但是，它需要正在運行的 Telegram 機器人服務。請依照下列步驟操作：

1. 安裝 python-telegram-bot 函式庫：

 pip3 install python-telegram-bot --upgrade

2. 重新命名config.py中的config-example.py ：

 mv config-example.py config.py

3. 編輯config.py檔案並插入您的 Telegram Bot 令牌TOKEN （您可以從 @BotFather 取得）、 URL和URL_TEST連結。

4. 執行web-app-launcher.py腳本：

 python3 web-app-launcher.py

5. 開啟 Telegram 機器人並將命令/start （用於生產連結）或/dev （用於測試連結）發送到機器人。
6. 按下按鈕開啟小程式的一個版本

現在，您可以使用測試連結啟動並測試您的小型應用程式。

資料模型

Telegram Cloud Storage 是一個可從任何 Telegram 用戶端存取的鍵值資料庫。它允許您為每個機器人的每個用戶儲存最多1024密鑰，每個值的長度限制為4096個字元。資料與使用者的 Telegram 帳戶關聯並跨裝置保留。掃描二維碼後，使用時間戳記作為金鑰儲存原始字串。

迷你應用程式在啟動時會載入完整的掃描歷史記錄並將其儲存在本機。後續掃描將儲存在 Telegram 雲端儲存和本機中。

根據二維碼的內容對檢索到的原始資料進行處理以提取資訊。支援的二維碼內容類型：

• 網址
• 電子卡
• 無線上網
• 地理
• 文字

刪除您的數據

在歷史記錄標籤中，展開您要刪除的二維碼，然後按Bin按鈕。此操作將從 Telegram 雲端儲存和本機儲存中刪除 QR 碼。小程式不儲存任何其他數據，也不使用cookie。

連續掃描

二維碼掃描器通常會在識別代碼後關閉。但是，您可以透過導覽至設定標籤並按Continuous Scan按鈕來啟用連續掃描模式。若要停用連續掃描模式，請再次按下該按鈕。您可以按左上箭頭退出連續模式。

觸覺回饋

成功掃描二維碼後，設備會振動以提供回饋。

調試和故障排除

在小應用程式的設定部分，您將找到用於調試和開發的有用工具：

• Sync Cloud Storage按鈕：此按鈕會將小型應用程式的本機儲存與 Telegram 雲端儲存同步，相當於開啟和關閉小型應用程式。
• Enrich QR codes按鈕：觸發所有掃描的原始 QR 代碼計算。
• 啟用Show debug顯示：
  • 本機快取的雲端儲存金鑰列表
  • 本機快取的雲端儲存鍵值列表
  • 本地豐富的雲端儲存密鑰資訊列表

成分

該專案使用 Vuetify，一個 Vue 元件框架庫。

執照

該代碼在 MIT 許可證下分發