プレゼンスの構造

Nowlyプレゼンスに必要なフォルダ構成を理解します。

フォルダ構成

プレゼンスは src 以下に配置され、名前の頭文字ごとにグループ化されます。

src/Y/YouTube/
|-- metadata.json
|-- presence.ts
`-- assets/
    |-- logo.png
    |-- icon.png
    `-- thumbnail.jpg

metadata.json

metadata.json には、プラットフォーム、対応URL、作者、カテゴリ、多言語対応の説明、マーケットプレイス用アセット、および discordNative などのオプションフラグが記述されます。

presence.ts

presence.ts にはランタイムロジックが含まれます。ページの状態を検出し、Presence APIを呼び出します。

utils/

複雑なプレゼンスの場合、ロジックを utils/ フォルダ配下の専用ファイルに分割してください。たとえばYouTubeプレゼンスでは、DOMヘルパー、チャンネル解析、Shorts判定を別々のモジュールに整理しています。

src/Y/YouTube/
|-- metadata.json
|-- presence.ts
|-- assets/
|   |-- logo.png
|   |-- icon.png
|   `-- thumbnail.jpg
`-- utils/
    |-- categories.ts
    |-- dom.ts
    |-- channel.ts
    |-- text.ts
    |-- bridge.ts
    |-- shorts-dom.ts
    |-- shorts-resolve.ts
    `-- youtube-data.ts

バンドラーは presence.ts からのローカルインポートを解決するため、ユーティリティファイルを通常どおりインポートできます。

import { findVideo } from "./utils/dom"
import { getChannelInfo } from "./utils/channel"

assets

アセットは、マーケットプレイス、インストールされたプレゼンスパッケージ、Discordのアクティビティペイロード、Open Graph画像で使用されます。

必須ファイル:

これらのサイズは正確な要件であり、プレゼンスのPRごとにCIでチェックされます。詳細はAssetsを参照してください。