설명
chrome.gcm
를 사용하여 앱 및 확장 프로그램이 Firebase 클라우드 메시징 (FCM)을 통해 메시지를 주고받도록 사용 설정합니다.
권한
gcm
속성
MAX_MESSAGE_SIZE
메시지에 포함된 모든 키-값 쌍의 최대 크기 (바이트)입니다.
값
4096
메서드
register()
chrome.gcm.register(
senderIds: string[],
callback?: function,
)
FCM에 애플리케이션을 등록합니다. 등록 ID는 callback
에서 반환됩니다. register
가 동일한 senderIds
목록으로 다시 호출되면 동일한 등록 ID가 반환됩니다.
매개변수
-
senderIds
문자열[]
애플리케이션에 메시지를 보낼 수 있는 서버 ID 목록입니다. 발신자 ID는 최소 1개에서 100개까지 포함해야 합니다.
-
콜백
함수 선택사항
callback
매개변수는 다음과 같습니다.(registrationId: string) => void
-
registrationId
문자열
FCM에서 애플리케이션에 할당한 등록 ID입니다.
-
반환 값
-
프로미스<string>
Chrome 116 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.
send()
chrome.gcm.send(
message: object,
callback?: function,
)
내용에 따라 메시지를 보냅니다.
매개변수
-
메시지
객체
FCM을 통해 상대방에게 보낼 메시지입니다.
-
데이터
객체
서버로 보낼 메시지 데이터입니다. 대소문자를 구분하지 않는
goog.
및google
와 대소문자를 구분하는collapse_key
는 키 접두사로 허용되지 않습니다. 모든 키-값 쌍의 합계가gcm.MAX_MESSAGE_SIZE
이하여야 합니다. -
destinationId
문자열
Google API 콘솔에서 할당한 메시지를 전송할 서버의 ID입니다.
-
messageId
문자열
메시지의 ID입니다. 애플리케이션 범위 내의 각 메시지에 대해 고유해야 합니다. ID 선택 및 처리에 대한 도움말은 클라우드 메시징 문서를 참조하세요.
-
timeToLive
숫자 선택사항
메시지의 TTL(수명)(초)입니다. 이 시간 내에 메시지를 보낼 수 없으면 onSendError 이벤트가 발생합니다. TTL(수명)이 0이면 메시지를 즉시 전송하거나 전송할 수 없는 경우 실패해야 함을 나타냅니다. TTL(수명)의 기본값은 86,400초(1일)이고 최댓값은 2,419,200초(28일)입니다.
-
-
콜백
함수 선택사항
callback
매개변수는 다음과 같습니다.(messageId: string) => void
-
messageId
문자열
콜백이 발급된 메시지의 ID입니다.
-
반환 값
-
프로미스<string>
Chrome 116 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.
unregister()
chrome.gcm.unregister(
callback?: function,
)
FCM에서 애플리케이션을 등록 취소합니다.
매개변수
-
콜백
함수 선택사항
callback
매개변수는 다음과 같습니다.() => void
반환 값
-
프로미스<void>
Chrome 116 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.
이벤트
onMessage
chrome.gcm.onMessage.addListener(
callback: function,
)
FCM을 통해 메시지가 수신되면 실행됩니다.
매개변수
-
콜백
함수
callback
매개변수는 다음과 같습니다.(message: object) => void
-
메시지
객체
-
collapseKey
문자열(선택사항)
메시지의 접기 키입니다. 자세한 내용은 비축소형 메시지 및 축소형 메시지를 참고하세요.
-
데이터
객체
메시지 데이터입니다.
-
출처:
문자열(선택사항)
메시지를 발행한 발신자입니다.
-
-
onMessagesDeleted
chrome.gcm.onMessagesDeleted.addListener(
callback: function,
)
앱 서버에서 애플리케이션으로 보낸 메시지를 FCM 서버가 삭제해야 할 때 실행됩니다. 이 이벤트 처리에 관한 자세한 내용은 메시지의 전체 기간을 참고하세요.
매개변수
-
콜백
함수
callback
매개변수는 다음과 같습니다.() => void
onSendError
chrome.gcm.onSendError.addListener(
callback: function,
)
FCM 서버에 메시지를 보낼 수 없을 때 실행됩니다.
매개변수
-
콜백
함수
callback
매개변수는 다음과 같습니다.(error: object) => void
-
오류
객체
-
세부정보
객체
오류와 관련된 추가 세부정보입니다(있는 경우).
-
errorMessage
문자열
문제를 설명하는 오류 메시지입니다.
-
messageId
문자열(선택사항)
오류가 특정 메시지와 관련된 경우 이 오류가 있는 메시지의 ID입니다.
-
-