Struktur Presence

Fahami susun atur folder yang diperlukan untuk presence Nowly.

Susun Atur Folder

Presence berada di bawah src, dikumpulkan mengikut huruf pertama namanya:

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

metadata.json

metadata.json menerangkan platform, URL disokong, pengarang, kategori, penerangan tempatan, aset marketplace dan bendera pilihan seperti discordNative.

presence.ts

presence.ts mengandungi logik runtime. Ia mengesan keadaan halaman dan memanggil Presence API.

utils/

Untuk presence yang kompleks, pisahkan logik anda ke dalam fail khusus di bawah folder utils/. Presence YouTube, sebagai contoh, menyusun pembantu DOM, penghuraian saluran dan penyelesaian Shorts ke dalam modul berasingan:

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

Bundler menyelesaikan import tempatan daripada presence.ts, jadi anda boleh mengimport fail utiliti seperti biasa:

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

assets

Aset digunakan oleh marketplace, pakej presence yang dipasang, muatan aktiviti Discord dan imej Open Graph.

Fail yang diperlukan:

Dimensi ini adalah keperluan tepat, disemak oleh CI pada setiap PR presence - lihat Assets untuk butiran.