SwitchBotWinの利用中によくある問題とその解決方法について解説します。
※本アプリは非公式の個人開発アプリです。SwitchBot公式とは一切関係ありません。
起動・インストールに関する質問
アプリをダブルクリックしても起動しません
以下の原因が考えられます。
- .NET 8.0 Desktop Runtime がインストールされていない: 本アプリは .NET 8.0 で動作します。ランタイムがインストールされていない場合、正しく起動しないか、インストールを求める画面が表示されます。Microsoftの公式サイトなどから「.NET 8.0 デスクトップ ランタイム（Windows用）」をダウンロードしてインストールしてください。
- すでにバックグラウンドで起動している: 本アプリは二重起動を防止するため、すでに起動している場合は新しくウィンドウを開きません。タスクバーのインジケーター（システムトレイ）やタスクマネージャーを確認し、すでに起動していないか確認してください。すでに起動している場合は、そのウィンドウが前面に表示されます。
- ZIPファイルの解凍が不十分なまま起動している: ダウンロードしたZIPファイルを解凍（展開）せずに、ZIPフォルダの内部から直接実行ファイルを起動すると、必要なDLLなどの関連ファイルが読み込めずエラーになります。必ず右クリックから「すべて展開」を行ってから起動してください。
Windows Defender（SmartScreen）の警告画面が表示されます
本アプリはオープンソースの個人開発アプリであり、コード署名証明書を適用していないため、Windowsのセキュリティ機能が「不明なアプリ」として警告を表示することがあります。
起動するには、警告画面内の「詳細情報」をクリックし、出現する「実行」ボタンをクリックしてください。
設定・デバイス連携に関する質問
デバイスの操作が反映されなかったり、エラーが表示されたりします
以下の点を確認してください。
- Open Token または Secret Key が誤っている: 設定画面で登録した「Open Token」および「Secret Key」に余分なスペースが入っていたり、文字が欠けていたりしないか確認してください。もう一度SwitchBotアプリから取得し直して貼り付けてください。
- 接続テストが成功するか確認する: アプリの「設定」から「接続テスト」を実行し、APIサーバーと正しく通信できているか確認してください。
- APIの1日あたりの呼び出し制限に達している: SwitchBot APIには1アカウントあたり「1日10,000回」の上限が設定されています。ダッシュボードや統計画面から、本日のAPI呼び出し状況を確認してください。上限に達している場合、翌日まで操作できなくなります。
一部のデバイスがアプリ上に表示されません
SwitchBotWinは、SwitchBot API v1.1 がサポートするデバイスの操作に対応しています。しかし、APIの仕様やデバイスの世代によっては、API経由での制御が制限されている場合があります。
対応デバイスの一覧については、仕様書 ページをご確認ください。
APIの累積呼び出し回数や残りの呼び出し可能回数はどこで確認できますか？
アプリのメニューバーから「表示」→「詳細統計情報」を選択して統計ダイアログを開くことで、本日のAPI累積呼び出し回数、残り回数、および日次上限（10,000回）の使用率をリアルタイムで確認できます。
セキュリティに関する質問
登録したOpen TokenやSecret Keyの安全性はどうなっていますか？
登録されたAPI認証情報（Open Token、Secret Key）は、Windows標準の暗号化セキュリティ機能である「DPAPI（データ保護API）」を使用して暗号化され、ローカルのPC内（C:\Users\ユーザー名\AppData\Roaming\SwitchBotWin\）に安全に保存されます。
この暗号化はWindowsのログインユーザーアカウントとハードウェア情報に紐づいているため、万が一ファイル自体がコピーされて他のPCに持っていかれたとしても、第三者がトークンを解読することはできません。また、これらのトークンはSwitchBotの公式APIサーバーとの通信（HTTPS）以外には送信されません。さらに設定ファイルのアクセス権はログインユーザー自身にのみ制限されます。
アプリをアンインストールした際、これらの設定情報も削除されますか？
ポータブル版の場合、アプリフォルダを削除するだけでは設定フォルダが残ります。設定情報も含めて完全に削除したい場合は、手動で以下の設定保存先フォルダを削除してください。 C:\Users\ユーザー名\AppData\Roaming\SwitchBotWin\ （※エクスプローラーに %APPDATA%\SwitchBotWin と入力すると開けます）
関連ページ
アプリのダウンロードは、ダウンロード ページから行えます。
詳しい使い方は、利用マニュアル を参照してください。
