工作與團隊

用指令碼自動傳檔到手機:命令列與 SDK

用 pdb 命令列,或 TypeScript 與 Python SDK,從你自己的指令碼把檔案、文字和連結傳到已配對的裝置,輕鬆自動化手機與電腦傳輸。

預覽版可用 更新日期 適用於
  • Windows
  • Linux

想快速自動化,可以在指令碼中呼叫 pdb 命令列,例如 pdb send <device> <file>。需要更深入的整合時,TypeScript 和 Python SDK 會和同一台電腦上的 Personal Device Bridge 代理程式溝通,可以列出裝置、傳送檔案、剪貼簿文字和連結,並對事件做出反應。SDK 目前還沒上架 npm 或 PyPI,需透過說明中心申請。

重點摘要

  • pdb 指令可加上 --json,輸出機器可讀的格式。
  • 提供 TypeScript(@personaldevicebridge/sdk)和 Python(personaldevicebridge)SDK。
  • 指令碼使用和 App 相同的動作,套用相同的裝置權限。
  • 只有你自己的使用者帳戶能存取本機代理程式。

操作步驟

  1. 執行代理程式

    桌面版 App 會執行它,你也可以用 pdb agent 啟動。pdb agent install 會讓它在登入時自動啟動。

  2. 試試命令列

    pdb devices 會列出已配對的裝置;pdb send <device> <files or folders>、pdb clip <device> "text" 和 pdb url <device> <address> 則用來傳送內容。

  3. 取得 SDK

    在正式發布前,套件和 API 參考文件採申請制提供,請參閱 使用 SDK 打造自己的整合。

  4. 連線並傳送

    你的指令碼會連到本機代理程式,呼叫和 App 相同的動作,例如把檔案傳到已配對的裝置。

安全性

SDK 透過受作業系統和權杖保護的私人通道與代理程式溝通,因此只有你自己的使用者帳戶能使用。裝置和權限完全依照你在 App 中的設定;指令碼無法做超出你允許範圍的事。

常見問題

SDK 有在 npm 或 PyPI 上嗎?

還沒有。請依照 使用 SDK 打造自己的整合 的說明申請套件和 API 參考文件。

其他電腦上的指令碼可以使用我的代理程式嗎?

不行。代理程式的通道僅限本機且只有擁有者能用;指令碼必須在同一台電腦上,以你的使用者帳戶執行。

支援哪些系統?

代理程式和 pdb 可在 Windows 和 64 位元 Linux 上執行,並能傳送到任何已配對的裝置,包括你的 Android 手機。