메타데이터

Nowly 프레즌스의 metadata.json 파일에 있는 필수 및 선택 필드를 모두 설명합니다.

필수 필드

모든 프레즌스에 필요한 항목:

예시

{
  "name": "YouTube",
  "author": {
    "name": "Nowly Developer",
    "github": "example"
  },
  "url": ["youtube.com", "www.youtube.com"],
  "color": "#FF0033",
  "category": "streaming",
  "description": {
    "en-US": "Watch and share videos on YouTube."
  }
}

작성자 및 기여자

• author - 라이브러리와 OG 이미지에 가장 먼저 표시되는 주 관리자.
• contributors - 프레즌스 제작에 도움을 준 추가 인물들.

설명 및 기능

• description - 로케일별로 키가 지정된 짧은 마켓플레이스 문구.
• longDescription - 상세 페이지용 확장 설명.
• features - 지원되는 동작(예: 버튼 지원, 미디어 키)의 현지화된 목록.

Discord 네이티브 지원

일부 플랫폼은 사용자가 계정을 연결하면 이미 Discord에 표시됩니다(Spotify가 대표적인 예입니다). 이 선택적 플래그를 설정하면 라이브러리가 그 연결 없이도 Nowly가 여전히 유용하다는 것을 설명할 수 있습니다.

{
  "name": "Spotify",
  "discordNative": true
}

이는 라이브러리 페이지와 확장 프로그램(스토어 및 설치된 프레즌스 상세정보)에 안내 문구를 표시할 뿐, 설치를 막지는 않습니다.

URL 매칭

• url - 페이지 매칭에 사용되는 지원 도메인 또는 URL 패턴.
• regExp - 복잡한 URL 패턴을 위한 정규식 기반 매칭.

실행 컨텍스트

두 개의 선택 필드는 브라우저에서 프레즌스 스크립트가 실행되는 방식과 시점을 제어합니다.

기본적으로 프레즌스는 isolated 환경에서 실행됩니다. 페이지의 DOM은 공유하지만 페이지의 JavaScript 컨텍스트는 공유하지 않습니다. 이는 안전한 기본값이며 거의 모든 프레즌스에서 작동합니다.

프레즌스가 페이지 컨텍스트가 필요한 경우, 특히 다음의 경우에는 "world": "main"을 설정하세요.

• 사이트가 window에 노출하는 플레이어 객체 같은 페이지 전역 변수를 읽어야 할 때
• 사용자의 세션 쿠키를 전달해야 하는 **동일 출처 인증 fetch**를 수행해야 할 때(예: 사이트의 내부 메타데이터 API)

{
  "name": "Netflix",
  "url": ["netflix.com", "www.netflix.com"],
  "world": "main",
  "color": "#E50914",
  "category": "streaming",
  "description": {
    "en-US": "Watch movies and series on Netflix."
  }
}

카테고리

허용되는 카테고리는 streaming, music, video, social, gaming, tools, ai, learning, creator, other입니다.