老灰鴨的筆記本

AS1102TL NAS 跑 kokoro 生成日語 mp3 語音檔

2026-10-16T01:40:03.209+08:00

參考資料 ----

以 mobaXterm 管理員權限登入 AS1102TL

要生成日語，需要 pyopenjtalk，下載並在 NAS 上進行編譯。

 
# 先在 AppCentral 找到 Entware 並安裝，這是 NAS 的套件管理
# 安裝的所有二進位檔、函式庫與標頭檔全都統一存放在 /opt（即 /volume1/.@plugins/AppCentral/entware/opt/）底下。
user$  opkg  update
user$  opkg  install  gcc  make  cmake

# The scripts cygdb, cython and cythonize are installed in '/volume1/.@plugins/AppCentral/python3/bin' which is not on PATH.

user$  export  TMPDIR=/volume1/tmp
user$  ~/.local/bin/pip3  install  cython  unidic-lite  --only-binary=:all:  --no-cache-dir


# 因為 pyopenjtalk 沒有提供適用於 ARM64 Linux + Python 3.12 的現成 Wheel 檔
# 所以要手動下載重新編譯
user$  cd /volume1/
# 建立暫存目錄 tmp
user$  mkdir  tmp
user$  cd  tmp
user$  mkdir  build_pyopenjtalk
user$  cd  build_pyopenjtalk
user$  ~/.local/bin/pip3  download  pyopenjtalk  --no-binary  :all:
# 本筆記下載了 pyopenjtalk-0.4.1.tar.gz
# 解壓縮
user$  tar  -xzf  pyopenjtalk-0.4.1.tar.gz
# 解壓縮的檔案放在 pyopenjtalk-0.4.1 目錄

user$  cd  /volume1/tmp/build_pyopenjtalk/pyopenjtalk-0.4.1/pyopenjtalk

# 這指令會將 openjtalk.pyx 生成 openjtalk.cpp
user$  python3  -m  cython  --cplus  openjtalk.pyx

# 以文字編輯軟體打開 openjtalk.cpp，如：vscode, notepad++...等，將這幾行插入 openjtalk.cpp 的第一列，再存檔
#include <unistd.h>
#include <limits.h>
#ifndef SSIZE_MAX
#define SSIZE_MAX LONG_MAX
#endif pyopenjtalk/openjtalk.cpp

# 可透過 head -n 6 pyopenjtalk/openjtalk.cpp 確認前幾行已包含這些定義。

user$  export  PATH=/opt/bin:$PATH
user$  export  CC=/opt/bin/gcc
user$  export  CXX=/opt/bin/g++
user$  export  TMPDIR=/volume1/tmp

# 這步驟會消耗蠻多時間...請耐心等候
user$  ~/.local/bin/pip3  install  .  --no-build-isolation  --no-cache-dir

# 日語假名/羅馬字轉換工具
user$  ~/.local/bin/pip3  install  jaconv  mojimoji  --no-cache-dir

合成日語 tts_jp.py

 
import os
import warnings
import io
import onnxruntime as ort
import soundfile as sf
from kokoro_onnx import Kokoro
from pydub import AudioSegment
from pydub.utils import which
from misaki import ja


# 限制執行緒數量，避免在 1GB RAM NAS 上過載
os.environ["OMP_NUM_THREADS"] = "2"
os.environ["ORT_NUM_THREADS"] = "2"

warnings.filterwarnings("ignore", category=UserWarning, module="joblib")

# 將靜態 ffmpeg 所在目錄放到環境變數 PATH 最前端
FFMPEG_DIR = "/volume1/Web/kokoro/ffmpeg-7.0.2-arm64-static"
os.environ["PATH"] = FFMPEG_DIR + ":" + os.environ.get("PATH", "")

# 明確指定使用支援 libmp3lame 的 ffmpeg 執行檔路徑
AudioSegment.converter = os.path.join(FFMPEG_DIR, "ffmpeg")
AudioSegment.ffmpeg = os.path.join(FFMPEG_DIR, "ffmpeg")


# 檔案路徑設定
MODEL_PATH = "/volume1/Web/kokoro/kokoro-v1.0.onnx"
VOICES_PATH = "/volume1/Web/kokoro/voices-v1.0.bin"
OUTPUT_MP3 = "/volume1/Web/mp3/lee_mood.mp3"


# 目標字串
text_input = "各作品はいくつかの世界設定を共有している。例外もあるが正式な作品のクレジットにはサンライズの共同筆名である矢立肇と、シリーズ第1作を手掛けた富野由悠季の名義を入れることが慣習となっている。"
text_input = "ガンダム（IP）は、映像作品を中心に、ガンプラなどのトイホビー、コンピュータゲーム、専門雑誌やコミックなどの書籍、ネットワークコンテンツ、アミューズメント施設など、さまざまな分野に展開する多角的な戦略を通じて、日本を代表するIPへと成長を遂げている。"

# 初始化 Kokoro ONNX
kokoro = Kokoro(model_path=MODEL_PATH, voices_path=VOICES_PATH)

# 初始化日語音素處理器 (Misaki G2P)
g2p = ja.JAG2P()
res = g2p(text_input)
phonemes = res[0] if isinstance(res, tuple) else res

# 將中文轉為 Kokoro 需要的音素格式
print(f"轉換音素結果: {phonemes}")

# 呼叫 create，傳入音素
print("正在合成語音...")
samples, sample_rate = kokoro.create(
    text=phonemes,
    voice="jf_nezumi",
    speed=1.0,
    is_phonemes=True
)


# 轉存為 MP3
# 先在記憶體中建立輕量 WAV 緩衝區，再由 pydub 調用 ffmpeg 封裝成 MP3
wav_buffer = io.BytesIO()
sf.write(wav_buffer, samples, sample_rate, format="WAV")
wav_buffer.seek(0)

audio_seg = AudioSegment.from_wav(wav_buffer)
audio_seg.export(OUTPUT_MP3, format="mp3", bitrate="192k")

print(f"完成！音訊已輸出至: {OUTPUT_MP3}")

2026-10-13T00:19:32.172+08:00

參考資料 ----

kokoro

以 mobaXterm 管理員權限登入 AS1102TL

因為 NAS AppCentral 的 FFmpeg 並不具生成 mp3 的能力，所以需要另外下載

 
user$  cd  /volume1/Web/kokoro/
user$  wget  https://johnvansickle.com/ffmpeg/releases/ffmpeg-release-arm64-static.tar.xz
user$  tar  -xf  ffmpeg-release-arm64-static.tar.xz

安裝 python3 的套件管理工具 pip

 
user$  curl  -sS  https://bootstrap.pypa.io/get-pip.py  -o  get-pip.py

# 透過本機 python3 執行安裝（建議加上 --user 避免破壞系統預設權限）
user$  python3  get-pip.py  --user

# 因為有加 --user 參數
# 所以 pip 會安裝在 user 家目錄的 ~/.local/bin

安裝輕量版的 kokoro-onnx

 
# 怕將 pip 路徑加入環境變數會對 NAS 造成影響，因此暫不加
# 執行 pip 時就必須輸入完整的 pip 路徑
user$   ~/.local/bin/pip3.12  install  --no-cache-dir  kokoro-onnx  soundfile  pydub

# 因為需中文音素支援，所以還要安裝 misaki 的中文模組
user$  ~/.local/bin/pip3.12  install  --no-cache-dir  kokoro-onnx  "misaki[zh]"

下載音色庫

 
# 建立一個目錄存放，在本筆記，我放在 /volume1/Web/kokoro

# 下載 ONNX 模型權重 (約 300MB)
user$  wget  -O  kokoro-v1.0.onnx  https://github.com/thewh1teagle/kokoro-onnx/releases/download/model-files-v1.0/kokoro-v1.0.onnx

# 下載音色庫 voices-v1.0.bin (約 25MB)
user$  wget  -O  voices-v1.0.bin  https://github.com/thewh1teagle/kokoro-onnx/releases/download/model-files-v1.0/voices-v1.0.bin

想知道有哪些音色

 
user$  python3  -c  "from  kokoro_onnx  import  Kokoro;  k=Kokoro('/volume1/Web/kokoro/kokoro-v1.0.onnx', '/volume1/Web/kokoro/voices-v1.0.bin'); print(k.get_voices())"

紅框內就是 kokoro 的角色音色，

第一個字母代表語言：

z：中文 (Zho / Chinese)

a：美式英語 (American English)

b：英式英語 (British English)

j：日語 (Japanese)

e：西班牙語 (Español)

f：法語 (Français)

h：印地語 (Hindi)

i：義大利語 (Italian)

p：巴西葡萄牙語 (Portuguese)

第二個字母代表性別，f 是女性(female)，m 是男性(male)。

目前 kokoro 的音色列表：

美語：

af_alloy, af_aoede, af_bella, af_heart, af_jessica, af_kore, af_nicole, af_nova, af_river, af_sarah, af_sky

am_adam, am_echo, am_eric, am_fenrir, am_liam, am_michael, am_onyx, am_puck, am_santa

英語：

bf_alice, bf_emma, bf_isabella, bf_lily,

bm_daniel, bm_fable, bm_george, bm_lewis

西班牙語：

ef_dora,

em_alex, em_santa

法語：

ff_siwis

印地語：

hf_alpha, hf_beta

hm_omega, hm_psi

義大利語：

if_sara

im_nicola

日語：

jf_alpha, jf_gongitsune, jf_nezumi, jf_tebukuro

jm_kumo, pf_dora

巴西葡萄牙語：

pm_alex, pm_santa

中文：

zf_xiaobei, zf_xiaoni, zf_xiaoxiao, zf_xiaoyi

zm_yunjian, zm_yunxi, zm_yunxia, zm_yunyang

警告訊息可以不理會，因為 joblib（底層用來處理並行運算的套件）在啟動時會嘗試在共享記憶體目錄（通常是 /dev/shm）建立旗標或暫存檔。在 ASUSTOR ADM 系統下，一般使用者帳號預設對 /dev/shm 沒有寫入權限，因此 joblib 自動降級為單線程序列模式（serial mode）運作。

因為在 1GB RAM 的 NAS 上本來就建議以單線程/序列模式執行以防爆記憶體，這個降級對生成語音完全沒有負面影響。

合成中文 tts_zh.py

 
import os
import warnings
import io
import onnxruntime as ort
import soundfile as sf
from kokoro_onnx import Kokoro
from pydub import AudioSegment
from pydub.utils import which
from misaki import zh


# 限制執行緒數量，避免在 1GB RAM NAS 上過載
os.environ["OMP_NUM_THREADS"] = "2"
os.environ["ORT_NUM_THREADS"] = "2"

warnings.filterwarnings("ignore", category=UserWarning, module="joblib")

# 將靜態 ffmpeg 所在目錄放到環境變數 PATH 最前端
FFMPEG_DIR = "/volume1/Web/kokoro/ffmpeg-7.0.2-arm64-static"
os.environ["PATH"] = FFMPEG_DIR + ":" + os.environ.get("PATH", "")

# 明確指定使用支援 libmp3lame 的 ffmpeg 執行檔路徑
AudioSegment.converter = os.path.join(FFMPEG_DIR, "ffmpeg")
AudioSegment.ffmpeg = os.path.join(FFMPEG_DIR, "ffmpeg")


# 檔案路徑設定
MODEL_PATH = "/volume1/Web/kokoro/kokoro-v1.0.onnx"
VOICES_PATH = "/volume1/Web/kokoro/voices-v1.0.bin"
OUTPUT_MP3 = "/volume1/Web/mp3/lee_mood.mp3"


# 目標字串
text_input = "你現在是怎樣的心情呢？是歡喜悲傷，還是一點點不知名的愁？"


# 初始化 Kokoro ONNX
kokoro = Kokoro(model_path=MODEL_PATH, voices_path=VOICES_PATH)

# 初始化中文音素處理器 (Misaki G2P)
g2p = zh.ZHG2P()
res = g2p(text_input)
phonemes = res[0] if isinstance(res, tuple) else res

# 將中文轉為 Kokoro 需要的音素格式
print(f"轉換音素結果: {phonemes}")

# 呼叫 create，傳入音素 (lang 改用 'en-us' 或省略驗證，is_phonemes=True)
print("正在合成語音...")
samples, sample_rate = kokoro.create(
    text=phonemes,
    voice="zm_yunyang",
    speed=1.0,
    is_phonemes=True
)


# 轉存為 MP3
# 先在記憶體中建立輕量 WAV 緩衝區，再由 pydub 調用 ffmpeg 封裝成 MP3
wav_buffer = io.BytesIO()
sf.write(wav_buffer, samples, sample_rate, format="WAV")
wav_buffer.seek(0)

audio_seg = AudioSegment.from_wav(wav_buffer)
audio_seg.export(OUTPUT_MP3, format="mp3", bitrate="192k")

print(f"完成！音訊已輸出至: {OUTPUT_MP3}")

合成美語 tts_en.py

 
import os
import warnings
import io
import onnxruntime as ort
import soundfile as sf
from kokoro_onnx import Kokoro
from pydub import AudioSegment
from pydub.utils import which
# from misaki import zh


# 限制執行緒數量，避免在 1GB RAM NAS 上過載
os.environ["OMP_NUM_THREADS"] = "2"
os.environ["ORT_NUM_THREADS"] = "2"

warnings.filterwarnings("ignore", category=UserWarning, module="joblib")

# 將靜態 ffmpeg 所在目錄放到環境變數 PATH 最前端
FFMPEG_DIR = "/volume1/Web/kokoro/ffmpeg-7.0.2-arm64-static"
os.environ["PATH"] = FFMPEG_DIR + ":" + os.environ.get("PATH", "")

# 明確指定使用支援 libmp3lame 的 ffmpeg 執行檔路徑
AudioSegment.converter = os.path.join(FFMPEG_DIR, "ffmpeg")
AudioSegment.ffmpeg = os.path.join(FFMPEG_DIR, "ffmpeg")


# 檔案路徑設定
MODEL_PATH = "/volume1/Web/kokoro/kokoro-v1.0.onnx"
VOICES_PATH = "/volume1/Web/kokoro/voices-v1.0.bin"
OUTPUT_MP3 = "/volume1/Web/mp3/lee_mood.mp3"


# 目標字串
text_input = "你現在是怎樣的心情呢？是歡喜悲傷，還是一點點不知名的愁？"
text_input = "American professors Robert E. Hall and Michael Woodford have won the 2026 Nobel prize in economics for developing new economic models that help governments and central banks stabilize their economies to minimize the impact of external shocks. "


# 初始化 Kokoro ONNX
kokoro = Kokoro(model_path=MODEL_PATH, voices_path=VOICES_PATH)


# 合成美語語音
print("正在合成美語語音...")
samples, sample_rate = kokoro.create(
    text=text_input,
    voice="af_alloy",      # 美語女聲 (亦可更換為 am_adam, af_sarah, af_nicole 等)
    speed=1.0,
    lang="en-us"           # 指定美語
)


# 轉存為 MP3
# 先在記憶體中建立輕量 WAV 緩衝區，再由 pydub 調用 ffmpeg 封裝成 MP3
wav_buffer = io.BytesIO()
sf.write(wav_buffer, samples, sample_rate, format="WAV")
wav_buffer.seek(0)

audio_seg = AudioSegment.from_wav(wav_buffer)
audio_seg.export(OUTPUT_MP3, format="mp3", bitrate="192k")

print(f"完成！音訊已輸出至: {OUTPUT_MP3}")

【Metabase】更新/升級 Metabase

2026-06-25T23:36:07.467+08:00

參考資料 ----

Upgrading Metabase#Upgrading the JAR

Metabase Full changelog

Release notes on GitHub.

本篇筆記環境：

VMware Workstation Pro 26H1

LinuxMint22.2

metabase v0.57.6

備份 metabase 的系統資料庫：因為我的 metabase 是裝在虛擬機 Linuxmint22.2，所以偷懶直接備份虛擬機的整個目錄；萬一更新/升級失敗也不怕。😁

目前(2026.06.25) metabase 官網列出的版本，最新版為 v62.3，而我的虛擬機內的版本 v57 的最新版修正版為 v57.20。

官方建議：不要一次貿然的將版本升級到最新，建議先更新至修正版(v57.20)，確定沒問題後再升級至最新版本(v62.3)。

登入 Linuxmint

 
# 停止 metabase 服務
user$ sudo  systemctl  stop  metabase.service

# 切換到存放 metabase.jar 的目錄
user$ cd  /usr/share/metabase/

# 將 metabase.jar 改名, 我習慣在原檔名後加上日期 → metabase_20260625.jar
user:/usr/share/metabase$ sudo  mv  metabase.jar  metabase_20260625.jar

# 開啟 Linuxmint 內的瀏覽器，找到自己的 metabase 主版本，本例為 57
# 主版本號 57 的最後一個版本為 57.20，以滑鼠右鍵複製連結網址
# 以指令模式下載最新版本的 metabase.jar
user:/usr/share/metabase$ sudo  wget  -O  metabase.jar  "https://downloads.metabase.com/v0.57.20.x/metabase.jar?_gl=1*1h59pic*_gcl_au*NTExNjgyNTUxLjE3ODIzODIxOTk."

# 變更 metabase.jar 的檔案屬性
user:/usr/share/metabase$ sudo  chown  metabase  metabase.jar
user:/usr/share/metabase$ sudo  chgrp  metabase  metabase.jar


# 重新開機，確定 metabase 能正常運作後，再重複上述的步驟升級至 v62.3

【軟體筆記】群暉(Synology) DS223j 設定 MariaDB + Python3 環境

2026-05-27T23:50:36.171+08:00

想要在 DS223j 跑 python 排程，因此摸索寫了這篇筆記；雖然 DS223j 底層也是 Linux，不過算是變形的 Linux，有其獨特性，所以本筆記的做法都是以不影響安全性及效率為前提。

老人家的 DS223j 系統已更新至 DSM7.2。

* 登入 DS223j web 管理系統 DSM，NAS 本身也有一些系統程式是以 python2 或 python3 撰寫，所以在【套件中心】會看到 python2 顯示已安裝，而 python3 雖然不是已安裝的狀態，但是若以 ssh 登入 DS223j 查看就會發現出廠時系統就安裝了 Python3.8.15。

因為我的程式要寫連線 DS223j 的 MariaDB，所以需要安裝【pymysql】套件，所以要與系統的 Python3.8.15 分開，另外再安裝套件中心的 Python3.9。

* 點選【套件中心】→【所有套件】→ 找到【Python3.9】並點擊安裝

* 以 ssh 連線進入 DS223j，本筆記採用的軟體為 MobaXterm，注意：NAS 和一般 Linux 不同，只允許系統管理者 ssh 連線。

python3.9 的安裝目錄路徑是 /var/packages/Python3.9/target/usr/bin/，執行檔名稱是 python3.9，在下圖中，可以看到套件中心自動為 python3.9 建立了 2 個捷徑，方便我們呼叫執行 python3.9。

 
# 切換到家目錄
admin@DS223j： cd ~

# 下載並安裝 pip
admin@DS223j：~＄ wget  https://bootstrap.pypa.io/pip/3.9/get-pip.py
admin@DS223j：~＄ /var/packages/Python3.9/target/usr/bin/python3.9  get-pip.py

# 安裝 pymysql
admin@DS223j：~＄ /var/packages/Python3.9/target/usr/bin/python3.9  -m  pip  install  pymysql

test.py

 
#!/usr/bin/env python3
# -*- coding: utf-8 -*-

import pymysql


# DS223j 預設關閉了 TCP/IP 連線協定
# 所以改用 socket
def get_db_connection_nas():
    """取得 NAS 資料庫連線"""
    # 請根據您的實際設定修改
    connection = pymysql.connect(
        user='資料庫連線帳號',
        password='密碼',
        database='資料庫名',
        unix_socket='/run/mysqld/mysqld.sock',
        charset='utf8',
        cursorclass=pymysql.cursors.DictCursor
    )
    return connection
    
    
def execute_and_print_query(pdo_nas, sql: str):
    print("\n" + "="*60)
    print(f"執行 SQL: {sql}")
    print("="*60)
    
    try:
        with pdo_nas.cursor() as cursor:
            # 執行 SQL 查詢
            cursor.execute(sql)
            rows = cursor.fetchall()
            if rows and len(rows) > 0:
                field_names = list(rows[0].keys())
                print(f"\n欄位: {', '.join(field_names)}")
                print("-"*60)
            
            # 取得記錄總數
            total_rows = len(rows)
            print(f"\n總共 {total_rows} 筆記錄\n")
            
            # 逐筆 print 出來
            for idx, row in enumerate(rows, 1):
                print(f"第 {idx} 筆記錄:")
                for field, value in row.items():
                    print(f"  {field}: {value}")
                print("-"*40)
            
            # 如果沒有記錄
            if total_rows == 0:
                print("查無任何記錄")
            
            return rows
            
    except Exception as e:
        print(f"執行 SQL 時發生錯誤: {e}")
        return None




def main():
    """主程式"""
    try:
        # 建立 mysql 連線
        pdo_nas = get_db_connection_nas()

        # 查詢記錄
        sql = "SELECT * FROM table1"
        result1 = execute_and_print_query(pdo_nas, sql)

        # 寫入紀錄
        sql_insert = f"""INSERT INTO table1
                        (field1, field2, field3)
                        VALUES
                        ('欄位1值', '欄位2值', '欄位3值')"""
                    
        print(f"sql = {sql_insert}")
        pdo_nas.cursor.execute(sql_insert)
        pdo_nas.commit()
        print("成功寫入")

    except Exception as e:
        print(f"發生錯誤: {e}")
        traceback.print_exc()
    


if __name__ == "__main__":
    main()

在儘量不更動 DS223j 的前提下，不改變 NAS 的環境變數，執行 test.py

 
# 須完整路徑，但可以是別名(捷徑)，所以下面 3 種呼叫方式都行得通
admin@DS223j:/$ /var/packages/Python3.9/target/usr/bin/python3.9 test.py
admin@DS223j:/$ /var/packages/Python3.9/target/usr/bin/python3 test.py
admin@DS223j:/$ /var/packages/Python3.9/target/usr/bin/python test.py

【Kotlin】自定義 app 結束對話框

2026-04-06T23:02:00.016+08:00

本筆記搭配使用 ViewBinding, AdMob, Edge-to-Edge

app 層級 build.gradle

 
android {
    
    compileSdk {
        version = release(36)
    }
...
...

    buildFeatures {
        viewBinding = true
    }
    
    defaultConfig {
        ...
        ...
        minSdk = 26
        targetSdk = 36
    }
}

...
...

dependencies {

    ...
    ...
    
    // adMob
    implementation("com.google.android.gms:play-services-ads:25.1.0")
}

strings.xml

 
<resources>
    
    <string name="dialog_title">確定要離開？</string>
    <string name="dialog_message">您確定要關閉應用程式嗎？</string>
    <string name="btn_cancel">取消</string>
    <string name="btn_exit">離開</string>
    
    ...
    ...
 
    <!-- adMob app id 測試 -->
    <string name="admob_app_id">ca-app-pub-3940256099942544~3347511713</string>
    <!-- 橫幅 測試 -->
    <string name="banner_ad_unit_id">ca-app-pub-3940256099942544/6300978111</string>
 
</resources>

AndroidManifest.xml

 
<manifest
 
    <!-- 存取網路連線 -->
    <uses-permission android:name="android.permission.INTERNET" />
 
    ...
    ...
 
    <application  ... >
 
        <meta-data
            android:name="com.google.android.gms.version"
            android:value="@integer/google_play_services_version" />
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="@string/admob_app_id" />
 
        ...
        ...
 
        <!-- AdMob 的 AdActivity -->
        <activity
            android:name="com.google.android.gms.ads.AdActivity"
            android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|uiMode|screenSize|smallestScreenSize"
            android:theme="@android:style/Theme.Translucent" />
 
        ...
        ...
 
    </application>
 
</manifest>

activity_main.xml

 
<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/main"    ← 注意這裡
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Hello World!"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent" />

</androidx.constraintlayout.widget.ConstraintLayout>

自定義對話框 dialog_exit.xml，因為版面很單純，所以採用 LinearLayout。

 
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:ads="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:orientation="vertical"
    android:padding="24dp">

    <TextView
        android:id="@+id/tv_dialog_title"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="@string/dialog_title"
        android:textSize="20sp"
        android:textStyle="bold"
        android:textColor="?attr/colorOnSurface"/>

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_marginTop="24dp"
        android:gravity="end"
        android:orientation="horizontal">

        <Button
            android:id="@+id/btn_cancel"
            style="?attr/borderlessButtonStyle"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="@string/btn_cancel" />

        <Button
            android:id="@+id/btn_exit"
            style="?attr/borderlessButtonStyle"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_marginStart="8dp"
            android:text="@string/btn_exit"
            android:textColor="?attr/colorError"/>

    </LinearLayout>

    <!-- 做為 banner 的容器 -->
    <FrameLayout
        android:id="@+id/adContainer"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_marginTop="16dp"
        android:minHeight="250dp" />
        
</LinearLayout>

MainActivity.kt

 
class MainActivity : AppCompatActivity() {
    private lateinit var binding: ActivityMainBinding
    
    private var preloadedAdView: AdView? = null    // 預載的廣告物件
    

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        enableEdgeToEdge()
        binding = ActivityMainBinding.inflate(layoutInflater)
        val view = binding.root
        setContentView(view)

        // 設定返回鍵攔截（支援新舊所有 Android 版本）
        setupBackPressedListener()
        
        ViewCompat.setOnApplyWindowInsetsListener(findViewById(R.id.main)) { v, insets ->
            val systemBars = insets.getInsets(WindowInsetsCompat.Type.systemBars())
            v.setPadding(systemBars.left, systemBars.top, systemBars.right, systemBars.bottom)
            insets
        }
        
        // 對話框的 AdMob banner
        preloadBannerAd()
    }

    
    override fun onPause() {
        preloadedAdView?.pause()
        super.onPause()
    }
    
    
    override fun onResume() {
        super.onResume()
        preloadedAdView?.resume()
    }


    override fun onDestroy() {
        preloadedAdView?.destroy()
        super.onDestroy()
    }
    
    
    private fun setupBackPressedListener() {
        val callback = object : OnBackPressedCallback(true) {
            override fun handleOnBackPressed() {
                // 當使用者按下返回鍵（或手勢返回）時，顯示對話框
                showExitCustomDialog()
            }
        }
        // 將 callback 加到 Dispatcher 中，它會自動處理生命週期
        onBackPressedDispatcher.addCallback(this, callback)
    }


    private fun showExitCustomDialog() {
        // 初始化 Dialog 的 View Binding
        val dialogBinding = DialogExitBinding.inflate(layoutInflater)
        
        // 將預載好的 AdView 放入對話框容器中
        preloadedAdView?.let { adView ->
            // 避免 AdView 重複被加入不同的 Parent
            (adView.parent as? ViewGroup)?.removeView(adView)
            dialogBinding.adContainer.addView(adView)
        }

        val dialog = MaterialAlertDialogBuilder(this)
            .setView(dialogBinding.root)
            .setCancelable(true)
            .create()

        dialogBinding.btnCancel.setOnClickListener {
            dialog.dismiss()
        }

        dialogBinding.btnExit.setOnClickListener {
            dialog.dismiss()
            finish()
        }

        dialog.show()
    }
    
    
    private fun preloadBannerAd() {
        preloadedAdView = AdView(this).apply {
            adUnitId = getString(R.string.banner_ad_unit_id)
            setAdSize(AdSize.MEDIUM_RECTANGLE)
            // 開始非同步載入
            loadAd(AdRequest.Builder().build())
        }
    }

}

實際的對話框效果

【Metabase】套用香港行政區進行分析 -- 區級行政區

2026-03-31T19:42:00.001+08:00

參考資料 ----

香港開放數據平台

到香港開放數據平台 → 點擊【數據集】→ 輸入【地方行政區分界】→ 下面會跳出【地方行政區分界】和【歷史地方行政區分界】→ 點擊【地方行政區分界】

→ 下面列出查詢結果【數據資源】

→ 我們要的就是【地方行政區分界 (英文／繁體中文) (JSON)】

→ 點擊【下載】鈕

香港的行政區有 18 個，所以下載的檔名為【hksar_18_district_boundary.json】。

【Metabase】套用台灣地圖進行分析(二) -- 區、里(村)級行政區

2026-03-22T16:56:00.002+08:00

參考資料 ----

github.com/g0v/twgeojson

政府資料開放平台：鄉鎮市區界線(TWD97經緯度)

村里界圖(TWD97經緯度)

到 github.com/g0v/twgeojson/json，有數個 json 檔，其中 twTown1982.geo.json 是區級行政區，twVillage1982.geo.json 則是里(村)級。

另有 twTown1982.topo.json 及 twVillage1982.topo.json，是 geo.json 的後繼優化格式，簡略記一下主要的差異：就是相鄰的 2 個區中間的界線不重複記錄。

例如：A 區與 B 區相鄰，geo.json 是完整地記錄 A 區的座標點 [1,2,3,4,5] 及 B 區的座標點 [1,6,7,8,9,2]，如此點 1 及點 2 就被記錄了 2 次，而 topo.json 則透過拓撲方法只記錄 1 次點1到點2 的弧線，相較之下，topo.json 的檔案就比較小。

而 Metabase 目前只支援 geojson 格式，所以我們就下載這 2 個檔，以 twTown1982.geo.json 為例

點擊 twTown1982.geo.json

→ 點擊【下載】圖示下載 json 檔

→ 將 twTown1982.geo.json 放置在 /var/www/html/ 下，然後在 Metabase 設定 twTown1982.geo.json 的 url，在本例為 http://localhost/twTown1982.geo.json

瞄一下檔案內容

 
{"type": "FeatureCollection",
 "features": [

 ...
 ...
 
    {"properties":{"TOWNSN":"64000002","TOWNID":"6400003","COUNTYNAME":"高雄市","TOWNNAME":"左營區","name":"高雄市/左營區"},
				   "type":"Feature",
				   "geometry":{"type": "Polygon", 
							   "coordinates": [[[ 120.274766995608132, 22.706593189102705 ], 
                                   ...
                                   ...
                               ]] 
							}
				},
    ...
    ...

登入 Metabase，點擊【齒輪】圖示

→ 管理員設定

→ 地圖 → 新增一個地圖

→【URL】輸入 http://localhost/twTown1982.geo.json

→【區域識別符】選擇 TOWNID

→【區域顯示名稱】選擇 TOWNNAME

g0v/twgeojson 的是 2014 年的資料，理論上這幾年並沒有重新劃分區級行政區，所以資料應該仍可信、準確。

g0v/twgeojson/json/twVillage1982.geo.json 則更細, 行政區範圍小至 "村/里"，村/里的劃分就可能不定期會變動了，例如老人家居住的里聽說最慢 2027 年就將要拆成 4 個里。

建立區級資料表存放 geojson 的資料，在本筆記，資料表命名為 town_geo

 
CREATE TABLE `town_geo` (
    `id` INT AUTO_INCREMENT PRIMARY KEY,
    `TOWNSN` VARCHAR(20),
    `TOWNID` VARCHAR(20),
    `COUNTYNAME` VARCHAR(50),
    `TOWNNAME` VARCHAR(50),
    `name` VARCHAR(100),
    `created_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP
)

寫一個 php 讀取 twTown1982.geo.json 並存入 town_geo

 
<?php
ini_set('display_errors', 1);
ini_set('memory_limit', '512M');    // 放寬記憶體限制, 才能讀大檔案

// 資料庫連線設定
$host = 'localhost';
$dbname = '資料庫名稱';
$username = '帳號';
$password = '密碼';

try {
    // 1. 建立 PDO 連線
    $pdo = new PDO("mysql:host=$host;dbname=$dbname;charset=utf8mb4", $username, $password);
    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

    // 2. 讀取並解析 GeoJSON 檔案
    $jsonFile = 'twTown1982.geo.json';
    if (!file_exists($jsonFile)) {
        die("錯誤：找不到檔案 $jsonFile");
    }

    $jsonContent = file_get_contents($jsonFile);
    $data = json_decode($jsonContent, true);

    if ($data === null) {
        die("錯誤：JSON 解析失敗");
    }

    // 3. 準備 SQL 插入語句
    $sql = "INSERT INTO town_geo (TOWNSN, TOWNID, COUNTYNAME, TOWNNAME, name) 
            VALUES (:townsn, :townid, :countyname, :townname, :name)";
    $stmt = $pdo->prepare($sql);

    // 4. 開始交易 (Transaction) 以提升大量寫入的速度
    $pdo->beginTransaction();

    $count = 0;
    foreach ($data['features'] as $feature) {
        $props = $feature['properties'];

        // 綁定參數並執行
        $stmt->execute([
            ':townsn'     => $props['TOWNSN'] ?? null,
            ':townid'     => $props['TOWNID'] ?? null,
            ':countyname' => $props['COUNTYNAME'] ?? null,
            ':townname'   => $props['TOWNNAME'] ?? null,
            ':name'       => $props['name'] ?? null
        ]);
        
        $count++;
    }

    // 5. 提交交易
    $pdo->commit();

    echo "成功！共匯入 $count 筆資料。";

} catch (PDOException $e) {
    // 發生錯誤時回滾
    if (isset($pdo) && $pdo->inTransaction()) {
        $pdo->rollBack();
    }
    echo "資料庫錯誤：" . $e->getMessage();
} catch (Exception $e) {
    echo "一般錯誤：" . $e->getMessage();
}
?>

如此就能結合自己的資料表，建立區級行政區的圖表了。

再建立里(村)級資料表，在本例為 village_geo

 
CREATE TABLE `village_geo` (
    `id` INT AUTO_INCREMENT PRIMARY KEY,
    `VILLAGESN` VARCHAR(20),
    `VILLAGEID` VARCHAR(20),
    `COUNTYNAME` VARCHAR(50),
    `TOWNNAME` VARCHAR(50),
    `VILLAGENAM` VARCHAR(50),
    `name` VARCHAR(150),
    `created_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP
)

寫一個 php 讀取 twVillage1982.geo.json 並存入 village_geo

 
<?php
// 1. 提高記憶體限制（針對較大的村里 GeoJSON 檔案）
ini_set('memory_limit', '512M');
set_time_limit(0); // 取消執行時間限制

// 資料庫連線設定
$host = 'localhost';
$dbname = '資料庫名稱';
$username = '帳號';
$password = '密碼';

try {
    // 2. 建立 PDO 連線
    $pdo = new PDO("mysql:host=$host;dbname=$dbname;charset=utf8mb4", $username, $password);
    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

    // 3. 讀取 GeoJSON 檔案
    $jsonFile = 'twVillage1982.geo.json';
    if (!file_exists($jsonFile)) {
        die("錯誤：找不到檔案 $jsonFile");
    }

    echo "正在讀取檔案...\n";
    $jsonContent = file_get_contents($jsonFile);
    
    echo "正在解析 JSON...\n";
    $data = json_decode($jsonContent, true);
    
    // 解析完立刻釋放字串記憶體
    unset($jsonContent); 

    if ($data === null) {
        die("錯誤：JSON 解析失敗，請檢查檔案格式。");
    }

    // 4. 準備 SQL 插入語句
    $sql = "INSERT INTO village_geo (VILLAGESN, VILLAGEID, COUNTYNAME, TOWNNAME, VILLAGENAM, name) 
            VALUES (:v_sn, :v_id, :c_name, :t_name, :v_name, :full_name)";
    $stmt = $pdo->prepare($sql);

    // 5. 開始交易處理 (大量資料寫入必備)
    $pdo->beginTransaction();

    echo "正在匯入資料...\n";
    $count = 0;
    foreach ($data['features'] as $feature) {
        $props = $feature['properties'];

        $stmt->execute([
            ':v_sn'      => $props['VILLAGESN'] ?? null,
            ':v_id'      => $props['VILLAGEID'] ?? null,
            ':c_name'    => $props['COUNTYNAME'] ?? null,
            ':t_name'    => $props['TOWNNAME'] ?? null,
            ':v_name'    => $props['VILLAGENAM'] ?? null,
            ':full_name' => $props['name'] ?? null
        ]);
        
        $count++;
    }

    // 6. 提交交易
    $pdo->commit();
    echo "匯入完成！成功存入 $count 筆村里資料。";

} catch (PDOException $e) {
    if (isset($pdo) && $pdo->inTransaction()) {
        $pdo->rollBack();
    }
    echo "資料庫錯誤：" . $e->getMessage();
} catch (Exception $e) {
    echo "一般錯誤：" . $e->getMessage();
}
?>

匯入的記錄如下圖

如果您需要的圖資精細顆粒度要小到村/里，國土測繪中心在政府資料開放平臺(opendata) 也有提供圖資，感覺有提續在更新，可能會較適合您，但國土測繪中心沒有直接提供 geo.json 格式，我們需要轉換程式幫忙。

到村里界圖(TWD97經緯度)，點擊【資料資源下載網址】，下載的是壓縮檔，找個目錄解壓縮存放，會看到解壓出來的檔案中有副檔名 .shp 的檔案，這是主檔。

到 QGIS 下載格式轉換程式並安裝，藉助程式將 shp 轉換為 geo.json 格式。

選擇 shp 檔，在本例為 VILLAGE_NLSC_1150306.shp

功能表【Layer】→【Save As】→【Format】欄位選擇 GeoJSON → 輸入檔名，在本例為 town_twd97 → 按下【確定】鈕

開啟檔案，會發現 properties 內的欄位跟上面 g0v 的不同，由此可知，properties 的欄位是各自定義的；所以，若您圖資是選擇國土測繪中心的，需注意匯入資料的欄位也會不同。

相關筆記 ----

套用台灣地圖進行分析(一) -- 市級行政區

【Metabase】限制/區隔一般 user 的查詢權限

2026-03-16T01:25:00.007+08:00

有時，基於工作/職務劃分，公司的資料會進行可視資料權限的控管；例如：行銷部的可以看到有關客戶名單，但不能看業務部有關銷售的業績、人事資料...等，反之亦然。

Metabase 社群版沒有限制使用者可視資料的功能(付費版才有)，也就是說，當系統管理員建立了一個資料庫連線，則所有 Metabase 的一般使用者都能看到該連線的所有 table。

不過我們有變通做法 -- 從資料庫分別設定幾個限制權限的帳號，本筆記以 MySQL8 做範例，例如建立帳號 user1(代表業務部)，只授予 user1 能查詢檢視 table1，建立帳號 user2(代表行銷部)，只能查詢檢視 table2。

以 root 帳號登入 phpMyAdmin 或登入 Linux 開一個命令列視窗然後建立一個 MySQL 連線，本例示範在 phpMyAdmin 操作

 
-- 建立使用者
CREATE  USER  'user1'@'localhost' IDENTIFIED BY '密碼';

-- 授予 USER1 查詢資料庫 db1 的 table1 的權限
GRANT  SELECT  ON  db1.table1  TO  'user1'@'localhost';

-- 刷新權限(選擇性命令, 通常會自動生效)
FLUSH  PRIVILEGES;

驗證：登出 phpMyAdmin，以 user1 登入，就能看到 user1 只能看到 db1 的 table1 的資料。

以管理員帳號登入 Metabase → 設定 → 管理員設定

資料庫 → 新增資料庫(以 MySQL8 為例)

輸入在前面為行銷建立的帳號 user1，並在【顯示名稱】輸入 sales(Linuxmint22.2 的 MySQL8 設定安裝可參考相關筆記)，重複步驟建立 user2，【顯示名稱】輸入 marketing。

到【權限管理】→【所有使用者群組】，這個群組預設是可查詢所有資料庫的，而且會高過其他群組的設定，所以要把 marketing、sales 的【建立提問】取消

設定業務部只能查詢 sales 資料庫

而行銷部只能查詢 marketing 資料庫

相關筆記 ----

LinuxMint22.2，設定為開機即啟動 Metabase 服務

【MySQL8】匯入大容量 .sql 檔

2026-01-26T16:36:00.000+08:00

phpMyAdmin 只能匯入容量 2M 以內的 .sql 檔，若要匯入大容量 .sql，則需要以命令列操作

 
# 切換到放置 .sql 檔的目錄下,
# 本例中, aa.sql 置於桌面
user$  cd  桌面

# 進入 su 模式
user$  sudo  su

# 匯入檔案
root#  mysql  -u  root  -p  資料庫名 < aa.sql

【Metabase】設定委託 Gmail 定時發送通知信件

2026-01-25T02:26:00.010+08:00

如果您設定的儀表板的數據是每日更新的，或是希望在您關心的某個數據發生較大的變化時(例如某日營業額突然暴量)通知您，就需要有台 mail server 寄送通知信件。

若您也沒有自己架設的 mail server，則可以申請 Gmail，設定 Metabase 委託 Gmail 寄送通知信件；Gmail 這項服務基本上是免費的，不過 Google 為了避免被用來惡意寄發垃圾信，所以有每日 500 封、且單封信件大小不可超過 10M 的限制。

登入 Google 帳戶

點擊右上角的帳戶圖示 → 【管理你的 Google 帳戶】

確認帳戶已啟用【兩步驟驗證】 → 在上方的搜尋框輸入【應用程式密碼】

為應用程式命名，在本例中，就叫做 metabase。

系統產生 16 字的密碼，複製/記下來。

以管理員登入 metabase → 點擊右上角的齒輪圖示 → 【管理員設定】

點擊【電子郵件設定】 → 【編輯配置】

參考下圖，填入各個欄位。

寄送測試信，會寄到管理員的信箱。

由於我的管理員 email 是 Gmail(但與申請 smtp.gmail.com 的帳號不同)，所以去 Gmail 看有沒有收到信，若有信寄來，就表示設定成功了。

拿 Metabase 現成自帶的範例儀表板實驗

打開 E-commerce Inshights 後，點擊儀表板右上角的【分享】圖示 → 【訂閱】

可以從 Metabase 的使用者名單選擇要訂閱的人，也可以自己輸入非 Metabase 使用者 → 選擇發送頻率。

若是同一個儀表板，有不同的人在看，在【訂閱】所指定的收信者是各自獨立設定的。
例如：A 已訂閱了 E-commerce Inshights，B 在【訂閱】是看不到有哪些人已經訂閱了 E-commerce Inshights 的。

點擊【現在發送郵件】，確認是否設定正確。

大約過 5 分鐘，去檢查信箱，就可以看到信件內容了。

信件是響應式(RWD) 的，包含了所有分頁的圖表及數據，個人覺得手機看也夠清楚。

【Metabase】套用台灣地圖進行分析(一) -- 市級行政區

2026-01-01T01:37:00.008+08:00

參考資料 ----

simplemaps

Metabase 預設自帶世界地圖 & 美國地圖，如果需要台灣地圖幫助我們進行資料分析，則要手動新增台灣圖資。

到 simplemaps 下載台灣的 GeoJSON 的檔案 -- 檔名 tw.json，瞄一下 json 檔的內容，包含了一級行政區，其中屬性 id, name 是我們需要的。

 
{
  "type": "FeatureCollection", 
  "features": [
    {
...
...

  "type": "Feature", 
      "properties": {
        "source": "https://simplemaps.com", 
        "id": "TWKIN", 
        "name": "Kinmen"
      }, 
      
...
...

因為在【LinuxMint 22.2 安裝設定 MySQL 8.0 + phpMyadmin】這篇筆記中，我們安裝了 phpMyadmin，所以 LinuxMint 一併安裝了 Apache，其網站根目錄位置為 /var/www/html/，

將 tw.json 放置在 /var/www/html/ 下，然後在 Metabase 設定 tw.json 的 url，在本例為 http://localhost/tw.json

登入 Metabase，點擊【齒輪】圖示

→ 管理員設定

→ 地圖 → 新增一個地圖

要注意的是：通常我們的資料庫中縣/市欄位並不是遵循 GeoJSON 的 ISO 名稱定義，所以需要做適當的轉換，例如：另外建一個對照用的 table。

 
對照資料表：city_geo
+--------+--------+-------+
|   id   |  英文  |  中文  |
+--------+--------+-------+
| TWKIN  | Kinmen | 金門  | 
+--------+--------+-------+
|  ...   |  ...   |  ...  |
+--------+--------+-------+

相關筆記 ----

套用台灣地圖進行分析(二) -- 區、里(村)級行政區

【Metabase】新增一般使用者

2025-12-31T22:24:00.011+08:00

點擊右上角的齒輪圖示

→ 管理員設定

點擊【邀請他人】

Metabase 是以 e-mail 做帳號管理，輸入 user 的 e-mail 後，若您或貴公司有自己的 mail server，Metabase 就會寄送含該 user 的密碼的信件到 e-mail 的信箱；在本筆記中，因沒有架設 mail server，所以要手動記下 Metabase 自動產生的密碼。

===== 2026.01.25 =====

可參考設定委託 Gmail 定時發送通知信件這篇筆記，設定 Gmail 做為 mail server，

不過要注意：一旦設定了 mail server ，之後新建的 Metabase 一般使用者的帳號就必須是真實的 e-mail，因為 Metabase 會將初始密碼寄到該 email。

若有設定 mail server，就看不到上圖的初始密碼，Metabase 會將密碼直接寄送到 e-mail。

登出管理員，讓剛剛新建的 user 登入

點擊齒輪圖示

→ 帳號設定

輸入剛才 Metabase 產生的密碼，再變更為自己希望的密碼，如果不符合 Metabase 的密碼規則，就會看到提示。

相關筆記 ----

設定委託 Gmail 定時發送通知信件

【Metabase】LinuxMint22.2，設定為開機即啟動 Metabase 服務

2025-12-28T10:27:00.004+08:00

參考資料 ----

Running Metabase on Debian as a service with nginx

Linux 的檔案權限與目錄配置

將 metabase.jar 移至 /usr/share/metabase/ 目錄

 
# 原本 metabase.jar 是放在 使用者家目錄下的 metabase 目錄內
[user]~$ cd  metabase
[user]$ sudo  su
[root]# groupadd  -r  metabase
[root]# useradd  -r  -s  /bin/false  -g  metabase  metabase
[root]# mkdir  /usr/share/metabase
[root]# cp metabase.jar  /usr/share/metabase
[root]# chown  -R  metabase:metabase  /usr/share/metabase
[root]# touch  /var/log/metabase.log
[root]# chown  syslog:adm  /var/log/metabase.log
[root]# touch  /etc/default/metabase
[root]# chmod  640  /etc/default/metabase

建立 metabase.service 服務檔

 
[root]# cd  /etc/systemd/system/
[root]# vim metabase.service
# 輸入下述內容
[Unit]
Description=Metabase server
After=syslog.target
After=network.target

[Service]
WorkingDirectory=/usr/share/metabase/
ExecStart=/usr/bin/java  -jar  /usr/share/metabase/metabase.jar
EnvironmentFile=/etc/default/metabase
User=metabase
Type=simple
StandardOutput=syslog
StandardError=syslog
SyslogIdentifier=metabase
SuccessExitStatus=143
TimeoutStopSec=120
Restart=always

[Install]
WantedBy=multi-user.target

:x 存檔離開

建立 syslog conf

 
[root]# vim  /etc/rsyslog.d/metabase.conf
# 輸入下述內容
if $programname == 'metabase' then /var/log/metabase.log
& stop

:x 存檔離開

# 重啟 rsyslog.service 以使 metabase.conf 生效
[root]# systemctl  restart  rsyslog.service

編輯 Metabase 的環境變數

 
[root]# vim  /etc/default/metabase
MB_PASSWORD_COMPLEXITY=strong
MB_PASSWORD_LENGTH=8    # 要求最短的密碼字串長度
MB_JETTY_HOST=0.0.0.0
MB_JETTY_PORT=3000
MB_DB_CONNECTION_URI="jdbc:mysql://localhost:3306/metabase?user=metabase&password=密碼&verifyServerCertificate=false&allowPublicKeyRetrieval=true"

MB_EMOJI_IN_LOGS=true    # log 要不要有顏文字...這還蠻有趣的...若不要就填 false
# any other env vars you want available to Metabase

:x 存檔離開

設定 metabase 為開機啟動

 
# 先手動啟動 metabase.service
[root]# systemctl  daemon-reload
[root]# systemctl  start  metabase.service
[root]# systemctl  status  metabase.service    # 觀察是否已啟動

# 另外再開瀏覽器, 看看是否能登入 metabase
# 確定執行沒問題了, 就改為開機自動啟動
[root]# systemctl  enable  metabase.service

相關筆記 ----

LinuxMint20.3 安裝設定免費，開源的 BI -- Metabase

LinuxMint22.2 上，社群版(Community) 將系統資料移至大型資料庫 MySQL8

【Metabase】LinuxMint22.2 上，社群版(Community) 將系統資料移至大型資料庫 MySQL8

2025-12-26T01:06:00.007+08:00

參考資料 ----

Migrating to a production application database

Configuring the Metabase application database

Metabase 自帶的系統資料庫為 H2，僅用於測試試用期間，若要轉為正式應用(production)，官方強烈建議將系統資料移至大型資料庫。

建議版本為 MySQL 5.7.7(含) 或 MariaDB 10.2.2(含) 或 PostgreSQL 9.4(含) 以上；本筆記為 MySQL 8.0.44。

注意：避免同時做 Metabase 更新升級及資料庫移植

關閉 Metabase，目前我的練功主機是開終端機視窗，在家目錄以

 
[user]~$ java  -jar  metabase.jar

的指令啟動 Metabase

所以只要在瀏覽器的 Metabase 頁面登出，然後在終端機視窗 Ctrl+C 中斷 Metabase 即可。

備份 H2︰複製 metabase.db.mv.db 到另一個安全的目錄存放。

以 root 登入 phpMyAdmin

在 MySQL 新增 metabase 帳戶並建立同名資料庫 metabase。

注意：建議密碼自已設定，而不要由 phpMyAdmin 幫您產生，以免密碼中不知道有哪個字元踩到了雷!!目前已知的有【@】、【:】、【/】、【?】、【#】，會造成 java 錯誤解析 URI 字串，若是一定要用時，則在組連線字串時，須將上述字元改成 URI 編碼，後面再進一步說明。

 
-- 重點在最後面的 "with grant option", phpMyAdmin 圖形界面似乎做不到賦予 grant 權限
GRANT ALL PRIVILEGES ON `metabase`.* TO 'metabase'@'localhost' with grant option;

執行移植指令

 
# 切換到 metabase.jar 所在目錄, 在本例為 [user]~/metabase/
[user]~/metabase$  export MB_DB_TYPE=mysql
[user]~/metabase$  export MB_DB_CONNECTION_URI="jdbc:mysql://localhost:3306/metabase?user=metabase&password=密碼&verifyServerCertificate=false&allowPublicKeyRetrieval=true"
[user]~/metabase$ java 　-DMB_DB_TYPE=mysql　 -DMB_DB_CONNECTION_URI="jdbc:mysql://localhost:3306/metabase?user=metabase&password=密碼&verifyServerCertificate=false&allowPublicKeyRetrieval=true" 　-jar　 metabase.jar 　load-from-h2　 metabase.db    # 注意檔名

前面提到，如果密碼非得要用那幾個特殊字元，則在組 java 的 JDBC 連線字串時，要改成 URI 編碼，如下：
@ → %40
: → %3A
/ → %2F
? → %3F
# → %23

因為有備份 H2，所以可以放心刪除 metabase 所在目錄下的 H2 檔案，以確認 metabase 存取的是 MySQL。

重新啟動 metabase

 
[user]~/metabase$  export MB_DB_TYPE=mysql
[user]~/metabase$  export MB_DB_CONNECTION_URI="jdbc:mysql://localhost:3306/metabase?user=metabase帳戶&password=密碼"
[user]~/metabase$  java 　-DMB_DB_CONNECTION_URI="jdbc:mysql://localhost:3306/metabase?user=metabase&password=密碼&verifyServerCertificate=false&allowPublicKeyRetrieval=true"  -jar  metabase.jar

重登入 metabase，可以看到之前製作的儀表板都在。

相關筆記 ----

LinuxMint22.2，設定為開機即啟動 Metabase 服務

LinuxMint22.2 安裝設定 MySQL 8.0 + phpMyadmin

【Database】LinuxMint 22.2 安裝設定 MySQL 8.0 + phpMyadmin

2025-12-21T01:24:00.022+08:00

參考資料 ----

ALTER USER Statement

* 這篇筆記是從 Mint Linux 20.3 安裝設定 MySQL 8.0 + phpMyadmin 那篇更新過來的，所以只要能理解、看得懂，部份截圖就沿用 LinuxMint20 的了。😇

VMWare Workstation 開放個人免費使用了！😄

新建一台 VMWare Workstation 虛擬機

偷懶，這次仍是安裝 MySQL，作業系統為 LinuxMint 22.2 MATE, MySQL 8.0。

安裝完成後，設定 "更新管理員" 的 "軟體來源" -- 鏡像站改為國內國家高速運算中心(https://www.nchc.org.tw/)。

安裝 vim(Mint 預設已裝 vi，這個適合 80 鍵鍵盤，老人家用不慣 😓)

 
~$  sudo  apt  install  vim

暫時關閉防火牆

 
~$  sudo  ufw  disable

# 確認防火牆沒有啟動
~$  sudo  ufw  status

安裝 MySQL，Mint 會連帶安裝其他相關的套件

 
~$  sudo  apt  install  mysql-server

安裝完成後，MySQL server 應該會自行啟動執行

 
# 下述 3 個指令只是順手筆記, 不執行

# 查詢 MySQL 狀態
~$  sudo  systemctl  status  mysql

# 啟動 mysql
~$  sudo  systemctl  start  mysql

# 停止 mysql
~$  sudo  systemctl  stop  mysql

安裝後，進行安全性設定

 
~$  sudo  mysql_secure_installation

問答式設定，依指示回答，以下是老人家的設定，請依自己需求設定

是否要設定密碼強度規則?

密碼強度選擇 -- 1：中等 -- 8 個字碼以上，其中必須至少 1 個大寫英文 + 至少 1 個小寫英文 + 至少 1 個數字 + 至少 1 個特殊字元

補充說明：密碼強度２(最強) -- 8 個字碼以上，除了必須滿足中等強度外 + 不能有容易被聯想的字(ex: P@ssw0rd → 可聯想到 password)，本來我想設最強，但嚐試了好幾次，都被判定不符合強度2 的規定，只好退而求其次，改選強度 1。

是否移除匿名使用者：我選 y

是否 "不允許" MySQL 的 root 從遠端登入 MySQL：我選 y

是否移除 test 資料庫(因為稍後設定 MySQL 時要指定 phpMyAdmin 啟動時預設連線的資料庫，所以先留著，不刪)

重新載入權限資料表：我選 y

設定完成

如果重新執行 mysql_secure_installation，上述的步驟會略過一開始的【設定密碼強度】，若想完整重新執行 mysql_secure_installation，則需要先移除密碼強度套件 component_validate_password

 
# 剛安裝好 MySQL 時，預設的管理者帳號是 root，所以, 第 1 次以命令形式登入 MySQL，也不需要密碼
~$ sudo  mysql

# 進到 MySQL, 提示字元變成 >
-- SQL 指令沒有大/小寫分別，不過慣例上都會以大寫表示
-- (記得要加 分號 做為命令的結束)

-- 查詢已安裝的元件
> SELECT * FROM mysql.component;
+--------------+--------------------+------------------------------------+
| component_id | component_group_id | component_urn                      |
+--------------+--------------------+------------------------------------+
|            1 |                  1 | file://component_validate_password |
+--------------+--------------------+------------------------------------+
1 row in set (0.00 sec)

-- 刪除密碼強度套件
> UNINSTALL COMPONENT 'file://component_validate_password';

-- 退出 mysql
> EXIT

設定 MySQL 時區為台北(Taipei)

 
~$  sudo  vim  /etc/mysql/mysql.conf.d/mysqld.cnf

[mydqld]
...
...
default-time-zone = '+8:00'

:x 存檔離開

 
# 再次登入 MySQL
~$  sudo  mysql


-- 建立資料庫(順手筆記, 不執行)
>  CREATE  資料庫名稱;


-- 列出目前 MySQL 已建立的使用者帳號(順手筆記, 不執行)
>  SELECT user FROM mysql.user;


-- 新建一個使用者 admin, 給後續安裝的 phpMyAdmin
>  CREATE USER 'admin'@'localhost' IDENTIFIED  WITH  caching_sha2_password  BY '密碼';
-- 預設的密碼格式為 caching_sha2_password
-- 其他格式有：mysql_native_password, sha256_password, ...
-- 不過官方還是推薦 caching_sha2_password


-- 賦予 admin 最高權限
>  GRANT  ALL  PRIVILEGES  ON  *.*  TO  'admin'@'localhost' WITH GRANT OPTION;

>  exit

注意：

MySQL 自 8.0 起預設不再支援 MyISAM 了

安裝 phpmyadmin

 
~$  sudo  apt  install  phpmyadmin

# 若安裝過程有失誤 或 不滿意, 想重新跑設定步驟, 可執行
~$  sudo dpkg-reconfigure phpmyadmin

因為這版的設定步驟跟之前不同，所以先選 <否>

再執行 dpkg-reconfigure phpmyadmin 重新設定

phpmyadmin 的帳戶改為我們在前面建立的 admin@localhost

打開本機的瀏覽器(預設是火狐Firefox)，在網址列輸入 http://localhost/phpmyadmin ，注意：不是 https

目前，我們還沒有啟用(加密)安全連線，也無法從別的電腦訪問這個內網

為 MySQL 的 root 帳戶加上密碼

 
~$  sudo  mysql

-- SQL 指令沒有大/小寫分別，不過慣例上都會以大寫表示
-- (記得要加 分號 做為命令的結束)
>  ALTER  USER  'root'@'localhost'  IDENTIFIED  WITH  CACHING_SHA2_PASSWORD  BY  '新密碼';

-- 退出，密碼才能生效
> EXIT


-- 從此之後登入 MySQL 就會要求您輸入密碼
~$  sudo  mysql  -u  root  -p
# 參數 -u 是要登入的使用者帳號
# -p 是稍後要輸入密碼
# 上面的指令按下 ENTER 後, 系統就會提示您要輸入密碼


# 另一種登入指令, 但不建議使用, 因為是將密碼以明碼方式顯示
#　注意: -p 跟密碼間沒有空格
# 但這麼一來, 您的密碼就顯示在命令列中, 旁人一覽無遺了
~$  sudo  mysql  -u  root  -p密碼


# 登入 MySQL 後, 提示字元變成 >
-- 檢視 root 帳戶
> SELECT  user,  host,  plugin,  authentication_string  FROM  mysql.user  WHERE  user='root';
+------+-----------+-----------------------+------------------------------------------------------------------------+
| user | host      | plugin                | authentication_string                                                  |
+------+-----------+-----------------------+------------------------------------------------------------------------+
| root | localhost | caching_sha2_password | $A$005$__HLm.}1*#ZzXhae2kc4K7Cvfg7TR0UxCxBKY2y2Ji9qieVGaXzMWL4Fn9 |
+------+-----------+-----------------------+------------------------------------------------------------------------+
1 row in set (0.00 sec)

【軟體筆記】Win10/11 安裝新酷音輸入法 + 倚天 26 鍵

2025-10-06T15:38:00.013+08:00

到新酷音官網下載安裝軟體到電腦指定的位置，例如：d:\download\

可以看到目前的最新版為 PIME-1.3.0-stable-setup.exe

滑鼠雙擊安裝程式，依指示安裝

此時您的電腦已安裝好新酷音了，您的電腦應該同時有預先安裝的微軟注音及新酷音

→ 點擊螢幕右下角的輸入法

→ 選取新酷音

滑鼠右鍵點擊新酷音左邊的【中】

→ 點選【設定新酷音輸入法】

此時，會開啟一個網頁，切換到【選字視窗外觀】頁籤

→ 【選字視窗選字鍵】改為 asdfghjkl;

切換到【鍵盤配置】頁籤

→ 改為倚天 26 鍵

順便看看【特殊符號】和【簡易符號輸入】這兩個頁籤的使用說明

最後按下【套用設定】鈕，就完成了！

下述的進階設定，對安裝了多種輸入法的電腦尤其好用！😄

點擊 Windows 的開始圖示

→ 【設定】

點擊選單【時間與語言】

→ 【輸入】

點擊【進階鍵盤設定】

【覆寫預設輸入法】改為【新酷音輸入法】

點擊【輸入語言快速鍵】

點選【切換到繁體中文(台灣) - 新酷音輸入(PIME)】

→ 點擊【變更按鍵順序】

設定為您偏好的按鍵組合，在本例為 Ctrl + Shift + 4

這樣您就可以快速切換輸入法到新酷音

相關筆記 ----

新酷音雙流劍(新酷音輸入法 + 倚天 26 鍵)

【軟體筆記】Win7 安裝新酷音輸入法 + 倚天 26 鍵

2025-09-27T11:11:00.010+08:00

到新酷音官網下載安裝軟體到電腦指定的位置，例如：d:\download\

可以看到目前的最新版為 PIME-1.3.0-stable-setup.exe

滑鼠雙擊安裝程式，依指示安裝

設定新酷音術入法

點選【新酷音輸入法(PIME)】

→ 按下【內容】鈕

此時，會開啟一個網頁，切換到【選字視窗外觀】頁籤

→ 【選字視窗選字鍵】改為 asdfghjkl;

切換到【鍵盤配置】頁籤

→ 改為倚天 26 鍵

順便看看【特殊符號】和【簡易符號輸入】這兩個頁籤的使用說明

最後按下【套用設定】鈕，就完成了！

相關筆記 ----

新酷音雙流劍(新酷音輸入法 + 倚天 26 鍵)

【軟體筆記】MobaXterm 取代 pietty

2025-09-15T21:58:00.001+08:00

最近買了 ASUSTOR AS1102TL，看到 AppCentral 中可以安裝 python3，想嚐鮮，但又找不到【終端機】之類的方式能進到命令列文字模式。

想到 AS1102TL 是屬 Linux 系統，就試試看以 SSH 連進去。

老人家之前慣用的 pietty 在建立連線時出現了錯誤訊息

看似是 pietty 不支援新的加密協定，上 pietty 官網，最新的版本仍停留在 0.4.00，跟現在我手上的版本一樣。

於是問了 DeepSeek 推薦有什麼替代軟體，試用了覺得 MobaXterm 不錯，可以記錄多台主機連線，好像還能開多個頁籤，可惜沒有中文界面(或是我沒找到？因為 DeepSeek 說有...)

程式畫面左邊會列出它偵測到的同區網內可連線的裝置

→ 在欲連線的裝置按滑鼠右鍵

→ Edit session

→ 確認是圈選 SSH

→ 輸入【Remote host】、【Specify username】

→ 點擊【OK】鈕

→ 提示要您輸入密碼

→ 第一次登入時，程式還會問您要不要儲存(記住)密碼，然後就登入了

【Android】Android15 停用無邊框方式顯示內容

2025-06-28T14:06:00.007+08:00

參考資料 ----

在檢視畫面中以無邊框方式顯示內容

行为变更：以 Android 16 或更高版本为目标平台的应用 -- 无边框设计停用退出选项

Android 自 Android10(Quince Tart, API29) 導入無邊框風格樣式，Android15(Vanilla Ice Cream, API35) 開始，新專案預設會是無邊框風格樣式，而自 Android16(BAKLAVA, API36) 開始則會強制 APP 預設外觀為無邊框風格樣式。

(題外話...看來 Build.VERSION_CODES 依字母排列只到 API35 為止了)

如果您的 targetSdkVersion 設為 35，當 APP 安裝在 Android15 時就會強制啟用無邊框顯示，若 APP 還未準備好，調整為無邊框，則可以 windowOptOutEdgeToEdgeEnforcement 先緩緩。

 
<resources
    xmlns:tools="http://schemas.android.com/tools">

    <style
        name="Theme.MyTheme"
        parent="Theme.Material3.DayNight.NoActionBar">

        <!-- 關閉 Edge-to-Edge(沈浸式無邊框) 功能 -->
        <item name="android:windowOptOutEdgeToEdgeEnforcement" tools:targetApi="35">true</item>
		
...
...
</resources>

不過 Android16(Baklava, SDK36) 起，windowOptOutEdgeToEdgeEnforcement 就失效了，該面對的跑不掉，開始調整自己的 APP 吧。

【Android】設定建構變化版本 -- 分開建立測試、正式版本 app

2025-06-21T11:39:00.010+08:00

參考資料 ----

設定建構變化版本

支援多個 APK

AdMob 的測試帳號

老人家的 app 有置入 AdMob 播放廣告，但 Google 要求 app 開發、測試期間，app 內的廣告要採用測試廣告，且抓得頗嚴，所以覺得蠻麻煩的。有時候，app 上架了才發現沒有換回正式廣告，就得再更正後再重上架...😒

偶然間，發現可以【設定建構變化版本】，這功能超好用的！

AdMob 的每種類型廣告都有個廣告 ID，在開發、測試期間要使用測試 ID，debug 時播放的廣告就會是測試廣告，要設定廣告，須在 /res/values/strings.xml 指定該類型廣告的 ID

 
<resources>
...
...

<!-- 上架前要 mark 起來 -->
<!-- adMob app id 測試 -->
<string name="admob_app">ca-app-pub-3940256099942544~3347511713</string>
<!-- 橫幅 測試 -->
<string name="admob_banner">ca-app-pub-3940256099942544/6300978111</string>
<!-- 插頁 測試 -->
<string name="admob_interstitial">ca-app-pub-3940256099942544/8691691433</string>
<!--  影片 測試 -->
<string name="admob_video">ca-app-pub-3940256099942544/5224354917</string>

<!-- 開發時期先 mark 起來，等要上架前再恢復 -->
<!-- adMob app id 正式 -->
<!-- <string name="admob_app">ca-app-pub-blablaXXXXXXXXXX~XXXXXXXXXX</string> -->
<!-- AdMob 橫幅 正式 -->
<!-- <string name="admob_banner">ca-app-pub-blablaXXXXXXXXXX/aaaaaaaaaa</string> -->
<!-- AdMob 插頁 正式 -->
<!-- <string name="admob_interstitial">ca-app-pub-blablaXXXXXXXXXX/bbbbbbbbbb</string> -->
<!-- AdMob 影片 正式 -->
<!-- <string name="admob_video">ca-app-pub-blablaXXXXXXXXXX/cccccccccc</string> -->

...
...
</resources>

現在，改在 app 層級的 build.gradle 設定

 
android {

...
...

    buildTypes {
        debug {
            // 開發、測試期
            applicationIdSuffix ".debug"    // debug 版本的 applicationId 會是 com.example.debug
            
            resValue 'string', 'app_name', '測試版 app'
            
            // adMob app id
            resValue "string", "admob_app_id", "ca-app-pub-3940256099942544~3347511713"
            // 橫幅 測試
            resValue "string", "banner_id", "ca-app-pub-3940256099942544/6300978111"
            // 插頁 測試
            resValue "string", "interstitial_id", "ca-app-pub-3940256099942544/8691691433"
        }

        release {
            // 正式
            resValue 'string', 'app_name', '正式版 app'
            
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'

            // adMob app id
            resValue "string", "admob_app_id", "ca-app-pub-blablaXXXXXXXXXX~XXXXXXXXXX"
            // 橫幅 正式
            resValue "string", "banner_id", "ca-app-pub-blablaXXXXXXXXXX/aaaaaaaaaa"
            // 插頁 正式
            resValue "string", "interstitial_id", "ca-app-pub-blablaXXXXXXXXXX/bbbbbbbbbb"
        }
    }

...
...
}

不僅如此，還可以設定測試版跟正式版不同的 applicationId，這麼做，就可以在同一支開發手機同時安裝測試版跟正式版 app。

功能表選擇 Build → Select Build Variant，會看到可編譯的版本的選項。

而 productFlavors 是 BuildTypes 的進階設定，可以變化出更多的 Build Variant，如下圖：

另有一個常見的情況：

某個特定的 API 在某版本起被棄用，Google 強制規定要改用新的 API(Google 還蠻常做這事的...所以要配合 Google，大約每半年要檢視自己的 app 是否能在各 Android 版本上正常運行)；例如：

app 原本在 API SDK30 前都可正常運行，但自 SDK31 起須改變程式寫法，在 build.gradle 設定 minSdkVersion 31，程式改好後，可將新版的 apk 取不同的檔名，上架到 PlayStore，如此，就分出新舊版本了，手機中的 PlayStore app 會自動判別，挑選最適合手機的版本 -- 手機版本在 SDK30 前的 user 會下載安裝舊版的 app，而手機版本在 SDK31 後的 user 則會下載新版的 app，不會因為 app 改版而放棄舊版本手機的 user。

【jQuery】jQuery + CSS 多個 checkbox 勾選

2025-06-08T17:53:00.001+08:00

 
<html>
<head>
<title>checkbox lab</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<script src="https://ajax.googleapis.com/ajax/libs/jquery/2.0.0/jquery.min.js"></script>
<script>
// chkAll 點擊事件
function checkAll() {
    var isChecked = $('#chkAll').prop('checked');
    // 更新所有 nameCheckbox 的狀態
    $('.nameCheckbox').prop('checked', isChecked).trigger('change');
}


// 更新 chkAll 狀態
function updateChkAll() {
    var totalCheckboxes = $('.nameCheckbox').length;
    var checkedCheckboxes = $('.nameCheckbox:checked').length;
    var $chkAll = $('#chkAll');
               
    if (checkedCheckboxes === 0) {
        // 全部未選中
        $chkAll.prop('checked', false);
        $chkAll.removeClass('partial');
    } else if (checkedCheckboxes === totalCheckboxes) {
        // 全部選中
        $chkAll.prop('checked', true);
        $chkAll.removeClass('partial');
    } else {
        // 部分選中
        $chkAll.prop('checked', false);
        // 關鍵修改：部分選中時保持 checked 但變灰色
        $chkAll.prop('checked', true).addClass('partial');
    }
}
</script>
<style type="text/css">
#chkAll {
    margin-bottom: 10px;
    font-size: 10px;
}
/* 部分選中時的灰色打勾 */
#chkAll.partial {
    accent-color: gray;  /* 現代瀏覽器 */
    filter: grayscale(50%) opacity(80%);  /* 舊瀏覽器備用 */
}
</style>
</head>
<body>
<center>
<form name="frmInput" id="frmInput" method="post" action="func.php">
<input type="hidden" name="act" value="input" />
<table border="1">
	<tr>
		<th nowrap="nowrap"><input type="checkbox" id="chkAll" onchange="checkAll()" />全選</th>
		<th nowrap="nowrap">姓名</th>
	</tr>
	<tr>
		<td><input type="checkbox" class="nameCheckbox" id="chk1" onchange="updateChkAll()" /></td>
		<td>張三</td>
	</tr>
	<tr>
		<td><input type="checkbox" class="nameCheckbox" id="chk2" onchange="updateChkAll()" /></td>
		<td>李四</td>
	</tr>
	<tr>
		<td><input type="checkbox" class="nameCheckbox" id="chk3" onchange="updateChkAll()" /></td>
		<td>王五</td>
	</tr>
</table>
</form>
</center>
</body>
</html>

【PHP】以 Telegram bot 取代 LINE notify

2025-02-16T00:27:00.009+08:00

* 先準備 2 支手機(在本筆記，2 支手機都是 Android)，telegram 沒法建立一人群組(應該說我沒試成功)

* 2 支手機都安裝 telegram，並建立一個群組

* 在尋找聯絡人輸入 @botfather，找到後，將 botfather 加入聯絡人

* 進入 botfather 的聊天室，會看到 botfather 的招呼語【What can this bot do?】

* 輸入【/start】，botfather 會列出一堆跟 bot 有關的指令

* 輸入【/newbot】

* botfather 會請您為您的 bot 取名字，因為後續的互動會是 json 格式，所以建議這次先以英文命名，較容易在 json 字串中辨識、找到。

* 接下來，botfather 請您設定您的 bot 的 id，bot 的 id 必須以【bot】結尾，ex：TetrisBot 或 tetris_bot，這個 id 必須是在 telegram 唯一的，所以若您設定的名字已經有別人先用了，botfather 會請您改名字。

* 建立您的 bot 後，可輸入【/help】進一步了解

* 輸入【/mybots】，會得到您的 bot 的 token，格式是【一串數字：大小寫英數字混合字串】很重要！請好好保存。

* 將 bot 加入群組

→ 由群組中的任一人發送一個訊息到群組

→ 點擊標題欄，可以看到這個群組的成員，並且下方有個標題為【Links】的區塊，點擊第一個連結(最後面以【/getUpdates】結尾)，就會看到一段 json 字串，將這段 json 字串複製出來，並尋找其中

 
...
...

"chat":{"id":-0123456789,
        "title":"mytest",
        "type":"group",
        "all_members_are_administrators":false
       }

...
...

這個就是群組的 id，通常是負數，type 是 group

如果找不到群組 id，請多試幾次(群組某人發送訊息，然後看 json 字串)，甚至將 bot 踢出群組再重加入。

寫個測試的 PHP 程式

 
<?php
date_default_timezone_set('Asia/Taipei');

$sToken = "0123456789:AAG9Sxwv3zc9YblablablaiBBJ3ZOUO4lFY";    // bot 的 token
$sGroupId = "-9876543210";	// 群組 id
 
// 訊息內容
$sMsg = "Hello, this is oldgrayduck's telegram Bot test, ".date('Y-m-d H:i:s');
 
$url = "https://api.telegram.org/bot$sToken/sendMessage";
$data = [
    'chat_id' => $sGroupId,
    'text' => $sMsg
];
 
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
 
$result = curl_exec($ch);
curl_close($ch);

// 顯示回應
echo $result;
 
?>

群組就會收到訊息了。

【LINE Messaging API】主動傳送訊息(推播) 給多位使用者

2024-12-30T10:03:00.006+08:00

類似主動傳訊息給 user，不過在傳訊類型定義為 multicast。要傳訊的目標對象是多位 user，所以 UserId 要存在陣列中。

 
<php?
date_default_timezone_set('Asia/Taipei');
$sRootDir = $_SERVER['DOCUMENT_ROOT'];
$channelAccessToken = '您的 channel Access Token';
$bodyMsg = file_get_contents('php://input');

// LINE 不會幫我們記錄, 所以要自己寫 log
// 這段不是必要, 只是方便自己除錯
$sLogfile = 'log_'.date('Ymd').'.log';    // 指定 log 檔名, 一天一個檔, 檔名格式為: log_yyyymmdd.log
$fp = fopen($sLogfile, "a+");
fwrite($fp , print_r(date('Y-m-d H:i:s').', Recive: '.$bodyMsg."\n", true));
fclose($fp);

...
...
// 取得 user id, 管道有很多, 此處不贅述
$arrUserId = ['...','...', ...];    ← 要推播的目標 UserId 存入陣列

$payload = [ 'to' => $arrUserId,
             'messages' => [
                               ['type' => 'text',
                                'text' => '恭喜! 您中了特獎!',
                               ]
                              ]
           ];
SendMsg($payload);


// 傳送訊息給指定使用者
function SendMsg($payload) {
    $ch = curl_init();
    // curl_setopt($ch, CURLOPT_URL, 'https://api.line.me/v2/bot/message/push');
    ↓ 注意這裡要改成 multicast
    curl_setopt($ch, CURLOPT_URL, 'https://api.line.me/v2/bot/message/multicast');
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
    curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
    curl_setopt($ch, CURLOPT_HTTPHEADER, [  'Content-Type: application/json',
                                            'Authorization: Bearer ' . $GLOBALS['channelAccessToken']
                                        ]);
    $result = curl_exec($ch);
    curl_close($ch);
    // 寫 log
    $sLogfile = 'log_'.date('Ymd').'.log';
    $fp = fopen($sLogfile, "a+");
    fwrite($fp , print_r(date('Y-m-d H:i:s').', send message result: '.$result."\n", true));
    fclose($fp);
}
?>

相關筆記 ----

【LINE Messaging API】主動傳送訊息給指定使用者

【Kotlin】隨機取出指定筆數的記錄

2024-08-28T18:47:00.006+08:00

題目：

有一含 1000 筆記錄的資料表 table1，要從中取出任意 100 筆

在詢問 Google 的 Gemini、OpenAI 的 ChatGPT、Perplexity 的 Perplexity、微軟的 Copilot 後，多認識了一些類別及技巧，故做此筆記。

做法一：

 
val mScope = CoroutineScope(Job() + Dispatchers.IO)
mScope.launch {
    val mDbHelper = SQLite(baseContext)
    var db = mDbHelper.readableDatabase

    // 查詢本機資料庫有幾筆記錄
    var sSql = "SELECT * FROM table1 "
    val rs = db.rawQuery(sSql, null)
    val mRecnt = rs.count    // 本機資料庫記錄筆數
    var mSentence = 100   // 迴圈數, 要取出 100 筆記錄

    val mList = mutableListOf<Int>()
    var xx = 1
    // 這種做法, 有可能亂數取得的 mPos 已存在 mList 中
    while(xx<=mSentence) {
        val mPos = (0 until mRecnt).random()    // 每筆記錄在 table1 的位置
        if(mPos !in mList) {
            mList.add(mPos)
            xx++
        }
    }
    mList.sorted()    // 將 mList 內的元素由小到大排序
    // 如此, 在實際自 table1 取出記錄就會是自資料表首一路向資料表尾依序取出記錄
    
    ...
    ...
}

做法二：

 
val mScope = CoroutineScope(Job() + Dispatchers.IO)
mScope.launch {
    ...
    ...

    val mRaw = mutableSetOf<Int>()    // mutableSet 的特性是存入時就會檢查每個元素的值都是唯一
    val mRandom = Random(System.currentTimeMillis())
    while(mRaw.size<mSentence) {
        mRaw.add(mRandom.nextInt(mRecnt))
    }
    // 但 mutableSet 不具排序功能, 
    // 故將它轉型態成 list 並排序後存入  mList
    val mList = mRaw.toList().sorted()
    
    ...
    ...
}

做法三：

 
val mScope = CoroutineScope(Job() + Dispatchers.IO)
mScope.launch {
    ...
    ...

    // 這個做法最快, 一行指令搞定
    // 以 shuffled() 洗牌後, 再以 take() 取前面幾個元素, 再將元素排序
    // (0 until mRecnt) 是 IntRange
    val mList = (0 until mRecnt).shuffled().take(mSentence).sorted()
    // val mList = (0 until mRecnt).shuffled(Random(System.currentTimeMillis())).take(mSentence).sorted()   // 可以在 shuffled() 內加上時間當做亂數種子, 增強其隨機性
    
    ...
    ...
}

【網頁程式】土砲打造 -- 依數個地點距離由近至遠規劃行程導航

2024-07-13T11:55:00.012+08:00

參考資料 ----

Directions API 總覽

當我們要前往數個地點，想依距離由近至遠排序，規劃開車行程，可以請 Google Cloud 服務，不過這是要收費的。

行程含目的地的停靠點在 10 個點以下，是一種費率，11(含)個點以上則會收較高的費用。

本筆記是自行計算及排序停靠點(注意，還是要收費的)。

申請服務憑證及 API 金鑰

您可以服務全開，不過我只使用其中 2 項 -- 取得地理位置(經緯度)、導航。

建立 GMap 類別

 
<?php 
date_default_timezone_set('Asia/Taipei');
  
// 用來查詢地址的經、緯度
class GMap {
    function getPageData($url) { 
        $ch = curl_init(); 
        curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_0);  
        curl_setopt($ch, CURLOPT_HTTPHEADER, array('Expect: '));
        curl_setopt($ch, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4); 
        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
        curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
        curl_setopt($ch, CURLOPT_URL, $url);
        curl_setopt($ch, CURLOPT_NOBODY, false);
        curl_setopt($ch, CURLOPT_FILETIME, true);
        curl_setopt($ch, CURLOPT_REFERER, $url); 
        curl_setopt($ch, CURLOPT_BINARYTRANSFER, true);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
        curl_setopt($ch, CURLOPT_FOLLOWLOCATION, 4);
        curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 10);
        curl_setopt($ch, CURLOPT_TIMEOUT, 10);
        curl_setopt($ch, CURLOPT_USERAGENT, "Mozilla/4.0 (compatible; MSIE 5.01; Windows NT 5.0)");
        $result['data'] = curl_exec($ch);
        curl_close($ch);
          
        return $result;
    }
    
    // 初始化 apikey 金鑰 
    function __construct() {
        $this->apikey = '向 Google map 申請 apikey';
    } 


    // 從 google map 取得地址經緯度
    public function getLngLat($addr='',$sDebug='') {
        $apikey = $this->apikey;
        $url = "https://maps.googleapis.com/maps/api/geocode/json?address=$addr&key=$apikey";
        $geocode = $this->getPageData($url);
        if($sDebug=='debug')
            var_dump($geocode);

        if(isset($geocode['data'])) {
            if(!$geocode["data"])
                // 當 Google map 解析不了時，回應 經/緯度值都是 -1 的虛擬經緯度
                $geocode = '{"results":[{"geometry":{"location":{"lat":-1,"lng":-1}}}]}';
            else
                $geocode = $geocode['data'];
        } else
            // 當 Google map 解析不了時，回應 經/緯度值都是 -1 的虛擬經緯度
            $geocode = '{"results":[{"geometry":{"location":{"lat":-1,"lng":-1}}}]}';

        $output = json_decode($geocode); 
        $latitude = $output->results[0]->geometry->location->lat;
        $longitude = $output->results[0]->geometry->location->lng; 
     
        return array('lat'=>$latitude,'lng'=>$longitude);
    }
}
?>

getroute.php，用來依次計算起點至每個目的地的距離，取最近的地址做為下個停靠點，並再以這地址做為下次計算的起點

 
<?php
// 切換至 https
if (empty($_SERVER['HTTPS']) || $_SERVER['HTTPS'] === "off") 
{
    $location = 'https://' . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'];
    header('HTTP/1.1 301 Moved Permanently');
    header('Location: ' . $location);
    exit;
}

include('gmap.php');

class MyDest {
    public $addr;
    public $len = 0;
    public $lng = -1;
    public $lat = -1;
  
    function __construct($aa) {
        $this->addr = $aa;
    }
}


if(isset($_GET['lat'])) {
    // 接收到起點 經/緯 度
    // $sLat = 22.612058525444247;    // 測試用
    // $sLng = 120.3142669919977;   // 測試用
    $sLat = $_GET['lat'];
    $sLng = $_GET['lng'];
    

    $aDest = array();    // 存放上傳的目的地
    $aSort = array();    // 排序後的目的地

    $gmap = new GMap();
    
    if(isset($_GET['dest1'])) {
        $obj = new MyDest($_GET['dest1']);
        $fLngLat = $gmap->getLngLat($obj->addr);    // 上車地點經緯度
        $obj->lat = $fLngLat["lat"];    // 緯度
        $obj->lng = $fLngLat["lng"];    // 經度
        array_push($aDest, $obj);
    }
    if(isset($_GET['dest2'])) {
        $obj = new MyDest($_GET['dest2']);
        $fLngLat = $gmap->getLngLat($obj->addr);    // 上車地點經緯度
        $obj->lat = $fLngLat["lat"];    // 緯度
        $obj->lng = $fLngLat["lng"];    // 經度
        array_push($aDest, $obj);
    }
    if(isset($_GET['dest3'])) {
        $obj = new MyDest($_GET['dest3']);
        $fLngLat = $gmap->getLngLat($obj->addr);    // 上車地點經緯度
        $obj->lat = $fLngLat["lat"];    // 緯度
        $obj->lng = $fLngLat["lng"];    // 經度
        array_push($aDest, $obj);
    }
    if(isset($_GET['dest4'])) {
        $obj = new MyDest($_GET['dest4']);
        $fLngLat = $gmap->getLngLat($obj->addr);    // 上車地點經緯度
        $obj->lat = $fLngLat["lat"];    // 緯度
        $obj->lng = $fLngLat["lng"];    // 經度
        array_push($aDest, $obj);
    }
    if(isset($_GET['dest5'])) {
        $obj = new MyDest($_GET['dest5']);
        $fLngLat = $gmap->getLngLat($obj->addr);    // 上車地點經緯度
        $obj->lat = $fLngLat["lat"];    // 緯度
        $obj->lng = $fLngLat["lng"];    // 經度
        array_push($aDest, $obj);
    }

    while(count($aDest)>0) {
        foreach($aDest as &$val) {    // 注意：$val 前面有 &
            // 計算【各目的地】距離【起點】的長度
            $url = "https://maps.googleapis.com/maps/api/directions/json?origin=$sLat,$sLng&destination=".urlencode($val->addr)."&key=$apiKey";
            
            // 目的地 destination 參數也可以是經緯度
            $url = "https://maps.googleapis.com/maps/api/directions/json?origin=$sLat,$sLng&destination=".urlencode($val->lat).",".urlencode($val->lng)."&key=$apiKey";
            
            // 若希望路線避開上高速公路, 則可加 avoid=highways 參數
            $url = "https://maps.googleapis.com/maps/api/directions/json?origin=$sLat,$sLng&destination=".urlencode($val->addr)."&avoid=highways&key=$apiKey";
            // 此外, 還可避開 ----
            // tolls：避開收費路段
            // highways：避開高速公路
            // ferries：避開渡輪
            // indoor：避開室內路線（主要用於步行路線）
            
            // 初始化 cURL
            $ch = curl_init();
            curl_setopt($ch, CURLOPT_URL, $url);
            curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
            $response = curl_exec($ch);
            curl_close($ch);
    
            // 解析 json 響應
            $data = json_decode($response, true);
            if ($data['status']=='OK') {
                $val->len = $data['routes'][0]['legs'][0]['distance']['value'];
            } else {
                $val->len = -1;
            }
            unset($val);
        }

        // 使用 usort 函數排序陣列，根據 $a 屬性值從小到大排序
        usort($aDest, function($a, $b) {
            return $a->len <=> $b->len;
        });
        // 排序後的第一個物件就是 距離最短的地址
        $minObj = $aDest[0];
        // print_r($aDest);
        array_push($aSort, ['addr' => ($minObj->addr)]);
        
        // 這個地址做為起點
        $sLat = $minObj->lat;
        $sLng = $minObj->lng;
        array_splice($aDest, 0, 1);
    }
    echo json_encode($aSort);   // 回傳依距離排序後的停靠點及目的地
}

?>

navi.php，將排好的順序丟給 GoogleMap 導航。

 
<?php
// 切換至 https
if(empty($_SERVER['HTTPS']) || $_SERVER['HTTPS'] === "off") 
{
    $location = 'https://' . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'];
    header('HTTP/1.1 301 Moved Permanently');
    header('Location: ' . $location);
    exit;
}
?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html style="height:100%;">
<head>
    <meta charset="utf-8">
    <script src="https://ajax.googleapis.com/ajax/libs/jquery/2.0.0/jquery.min.js"></script>
</head>
<body>
<br />
<button onclick="startNavigation()" style="font-size:40pt;">巡航</button><br />
<span  style="font-size:40pt;">提醒：在 Android Chrome 開啟本網頁</span><br />
<br />
<br />
<script>
function startNavigation() {
    var aRoute = [
        "高雄市苓雅區四維三路2號",
        "高雄市前鎮區中華五路789號",
        "高雄市鼓山區濱海二路1號",
        "高雄市左營區博愛二路777號",
        "高雄市左營區高鐵路107號"
    ];

    if (navigator.geolocation) {
        navigator.geolocation.getCurrentPosition(function(position) {
            var latitude = position.coords.latitude;    // 緯度
            var longitude = position.coords.longitude;  // 經度
            var str = "https://您自己的網址/getroute.php?lat="+latitude+"&lng="+longitude+"&dest1="+aRoute[0]+"&dest2="+aRoute[1]+"&dest3="+aRoute[2]+"&dest4="+aRoute[3]+"&dest5="+aRoute[4];
            // alert('str = '+str);
            // return;

            var destinations = new Array();
            $.getJSON(str, function(res) {
                // alert("res = "+res);
                // 這段是從 client 端向 server 請求查詢
                // server 回傳 json 型態的陣列
                // 陣列內的元素是 addr
                res.forEach(function(element) {
                    destinations.push(element.addr);
                });
                var waypoints = destinations.map(function(destination) {
                    // Google map 規定停靠點以【|】字元分隔
                    // 將 5 個地點以【|】字元分隔
                    return encodeURIComponent(destination);
                }).join("|");
                destination = waypoints.split('|').pop();   // 取得最後【|】右邊的字串做為目的地
                waypoints = waypoints.slice(0, waypoints.lastIndexOf('|')); // 取得最後【|】的左邊字串做為停靠點

                // 構建導航 URL
                var mapsURL = "https://www.google.com/maps/dir/?api=1&origin=" + latitude + "," + longitude + "&destination=" + destination + "&waypoints=" + waypoints + "&travelmode=driving";
                // alert(mapsURL);
                // return;

                // 跳轉到 Google Maps
                window.location.href = mapsURL;
            });
            // return;
            

            
        }, function(error) {
                alert("無法取得地理位置: " + error.message);
            }
        );
    } else {
        alert("瀏覽器不支援地理定位功能。");
    }
}
</script>
<br />
<br />
</body>
</html>

排序後，程式呼叫 Android 手機上的 Google Map app 進行導航。

第一次執行這個網頁程式時，會詢問是否同意瀏覽器存取你的地理位置，選擇同意且記住您的選擇，之後執行就不會再跳出詢問視窗了。

測試 Google Chrome、Firefox、Microsoft Edge 這幾個主流瀏覽器

Chrome 效果最佳，直接啟動 Google Map，畢竟都是自家的產品；

Edge 雖可呼叫 Google Map，但詢問視窗一直開著，不會自動關閉

Firefox 最差，啟動了 Google Map，但要導航的地址全不見了!!

另一個有趣的發現：

如果只單純導航前往一個地點，Google Map 並不管目的地是否與您的行車方向順向，只要抵達目的地附近，Google Map 就認為任務完成了。ex：出發點是高雄市中山大學，目的地是高雄女中(雄女)，雄女的對面是國軍英雄館，Google 導航只要帶您到國軍英雄館，導航就結束了。

但當設了多個停靠點時，Google Map 就會使命必達，規劃的路線即使繞一圈也會帶您順向抵達雄女。

然後...老人家又好奇了...這個網頁程式在 iPhone 上打開會是什麼結果?

答案是：在 Safari 直接 Deny!! 不給開

2025

相關筆記 ----

【PHP】Google Maps API -- 將地址轉換成經緯度座標

老灰鴨的筆記本

AS1102TL NAS 跑 kokoro 生成日語 mp3 語音檔

在 ASUSTOR AS1102TL NAS 跑 kokoro tts(text-to-speech) 生成 mp3 語音檔

【Metabase】更新/升級 Metabase

【軟體筆記】群暉(Synology) DS223j 設定 MariaDB + Python3 環境

【Kotlin】自定義 app 結束對話框

【Metabase】套用香港行政區進行分析 -- 區級行政區

【Metabase】套用台灣地圖進行分析(二) -- 區、里(村)級行政區

【Metabase】限制/區隔一般 user 的查詢權限

【MySQL8】匯入大容量 .sql 檔

【Metabase】設定委託 Gmail 定時發送通知信件

【Metabase】套用台灣地圖進行分析(一) -- 市級行政區

【Metabase】新增一般使用者

【Metabase】LinuxMint22.2，設定為開機即啟動 Metabase 服務

【Metabase】LinuxMint22.2 上，社群版(Community) 將系統資料移至大型資料庫 MySQL8

【Database】LinuxMint 22.2 安裝設定 MySQL 8.0 + phpMyadmin

【軟體筆記】Win10/11 安裝新酷音輸入法 + 倚天 26 鍵

【軟體筆記】Win7 安裝新酷音輸入法 + 倚天 26 鍵

【軟體筆記】MobaXterm 取代 pietty

【Android】Android15 停用無邊框方式顯示內容

【Android】設定建構變化版本 -- 分開建立測試、正式版本 app

【jQuery】jQuery + CSS 多個 checkbox 勾選

【PHP】以 Telegram bot 取代 LINE notify

【LINE Messaging API】主動傳送訊息(推播) 給多位使用者

【Kotlin】隨機取出指定筆數的記錄

【網頁程式】土砲打造 -- 依數個地點距離由近至遠規劃行程導航