JavaScript용 Azure Notification Hubs SDK

Azure Notification Hubs는 백 엔드(클라우드 또는 온-프레미스)에서 모든 플랫폼(Apple, Amazon Kindle, Firebase, Baidu, Xiaomi, Web, Windows 등)에 알림을 보낼 수 있는 스케일 아웃 푸시 엔진을 제공합니다. Notification Hubs는 엔터프라이즈 및 소비자 시나리오 모두에서 잘 작동합니다. 다음은 몇 가지 샘플 시나리오입니다.

• 수백만 명의 사용자에게 대기 시간이 짧은 최신 뉴스 알림을 보냅니다.
• 관심 있는 사용자 세그먼트에 위치 기반 쿠폰을 보냅니다.
• 미디어/스포츠/금융/게임 애플리케이션을 위해 사용자 또는 그룹에 이벤트 관련 알림을 보냅니다.
• 프로모션 콘텐츠를 애플리케이션에 푸시하여 고객을 참여시키고 마케팅 활동을 전개합니다.
• 사용자에게 새 메시지 및 작업 항목과 같은 엔터프라이즈 이벤트를 알립니다.
• 다단계 인증을 위한 코드를 보냅니다.

주요 링크:

• 소스 코드
• 패키지(npm)
• 제품 설명서
• 샘플

참고: 패키지를 사용하는 경우 다음을 azure-sb 참조하세요. migration guide to move from azure-sb to @azure/notification-hubs

시작

현재 지원되는 환경

• Node.js의 LTS 버전
• 최신 버전의 Safari, Chrome, Edge, Firefox.

자세한 내용은 지원 정책을 참조하세요.

패키지 설치

npm install @azure/notification-hubs

사전 요구 사항

• Azure 구독
• App Notification Hubs 리소스.

Azure Notification Hubs 리소스 Create

Azure Notification Hub는 다음 방법을 사용하여 만들 수 있습니다.

1. Azure Portal
2. Azure CLI
3. Bicep
4. ARM 템플릿

만든 후에는 Azure Portal 또는 Azure CLI를 사용하여 Notification Hub를 구성할 수 있습니다.

클라이언트 가져오기

JavaScript용 이 SDK는 클래스 기반 접근 방식이나 모듈식 디자인 접근 방식을 통해 Azure Notification Hubs와 상호 작용하는 두 가지 방법을 제공합니다. 클래스 기반 접근 방식은 클라이언트를 만든 다음 클라이언트의 메서드와 상호 작용하기 위해 모든 패키지에서 일관됩니다.

import {
  NotificationHubsClient,
  createAppleInstallation
} from "@azure/notification-hubs";

const client = new NotificationHubsClient("<connection string>", "<hub name>");

const installation = createAppleInstallation({
  installationId: "<installation-id>",
  pushChannel: "<push-channel>",
  tags: ["likes_javascript"],
});

const result = await client.createOrUpdateInstallation(installation);

모듈식 접근 방식을 사용하면 개발자가 각 메서드가 개별적으로 노출될 때 가져올 함수를 선택하고 선택할 수 있습니다. 이 방법은 ES-Modules 하위 경로 내보내기를 사용하여 직접 가져오기를 통해 메서드를 노출합니다. 개별 내보내기를 사용하면 더 나은 트리 흔들림 환경과 개발자가 활용할 수 있는 더 작은 번들 크기를 만듭니다.

클라이언트 만들기는 하위 경로를 통해 "@azure/notification-hubs/api" 노출되며 모든 클라이언트 메서드는 하위 경로를 통해 "@azure/notification-hubs/api" 노출됩니다. 내보낸 각 함수는 를 client 첫 번째 매개 변수로 사용하고 나머지 매개 변수는 변경되지 않은 상태로 유지됩니다.

다음 하위 경로가 노출됩니다.

• @azure/notification-hubs/api- 또는 와 같은 getInstallation 클라이언트 메서드를 통해 createClientContext 클라이언트에 대한 기본 진입점sendNotification
• @azure/notification-hubs/models - Notification Hubs 모델 및 팩터리 메서드.

위의 코드 조각은 다음이 됩니다.

import { createClientContext, createOrUpdateInstallation } from "@azure/notification-hubs/api";
import { createAppleInstallation } from "@azure/notification-hubs/models";

const context = createClientContext("<connection string>", "<hub name>");

const installation = createAppleInstallation({
  installationId: "<installation-id>",
  pushChannel: "<push-channel>",
  tags: ["likes_javascript"],
});

const result = await createOrUpdateInstallation(context, installation);

클라이언트 인증

Azure Notification Hub와의 상호 작용은 NotificationHubsClient공유 액세스 서명 연결 문자열을 지원하는 에서 시작됩니다. 여기에는 수신 대기, 관리, 보내기 권한 수준이 포함됩니다.

수신 대기를 사용하면 클라이언트가 등록 및 설치 API를 통해 자신을 등록할 수 있습니다. 보내기를 사용하면 클라이언트가 송신 API를 사용하여 디바이스에 알림을 보낼 수 있습니다. 마지막으로, 관리를 사용하면 사용자가 쿼리와 같은 등록 및 설치 관리를 수행할 수 있습니다.

연결 문자열 및 Notification Hub 이름이 있는 생성자를 사용하여 새 NotificationHubsClient 클라이언트를 만들 수 있습니다.

import { NotificationHubsClient } from "@azure/notification-hubs";

const client = new NotificationHubsClient("<connection string>", "<hub name>");

모듈식 접근 방식을 createClientContext 사용하여 하위 경로를 통해 "@azure/notification-hubs/api" 를 가져올 수 있습니다.

import { createClientContext } from "@azure/notification-hubs/api";

const context = createClientContext("<connection string>", "<hub name>");

주요 개념

NotificationHubClient 가 초기화되면 다음 개념을 탐색할 수 있습니다.

• 설치 및 등록설정을 통한 장치 관리
• 디바이스에 알림 보내기

디바이스 관리

디바이스 관리는 APN 또는 Firebase와 같은 네이티브 PNS(플랫폼 알림 서비스) 및 대상 그룹에 푸시 알림을 보내는 데 사용되는 태그와 같은 관련 메타데이터에서 고유 식별자를 저장할 수 있도록 Notification Hubs의 핵심 개념입니다. 이 작업은 최신 기본 설정 메커니즘인 설치 API와 등록이라는 두 개의 API를 사용하여 수행됩니다.

설치 API

설치는 대상 그룹에게 보내는 데 사용할 수 있는 설치 ID 및 사용자 ID와 같은 추가 속성을 포함하는 디바이스 관리에 대한 최신 네이티브 JSON 접근 방식입니다. 설치 API는 다음과 같은 방법으로 기존 등록 API에 비해 몇 가지 이점이 있습니다.

• 완전 idempotent API이므로 설치 시 를 호출하면 중복에 대한 걱정 없이 작업을 다시 시도 할 수 있습니다.
• userId 및 와 같은 $InstallationId:{myInstallId} 태그 식에 사용할 수 있는 및 installationId$UserId:{bob@contoso.com}속성을 지원합니다.
• 템플릿은 이제 별도의 등록 대신 설치의 일부이며 이름으로 전송을 위한 태그로 참조할 수 있습니다.
• 부분 업데이트는 먼저 설치를 쿼리하지 않고도 태그를 추가하고 다른 데이터를 변경할 수 있는 JSON 패치 표준을 통해 지원됩니다.

다음과 같은 메서드를 통해 설치를 createOrUpdateInstallation 만들 수 있습니다.

import { NotificationHubsClient, createAppleInstallation } from "@azure/notification-hubs";
import { v4 as uuid } from "uuid";

const client = new NotificationHubsClient("<connection string>", "<hub name>");

// Create an installation for APNs
let installation = createAppleInstallation({
  installationId: uuid(), // Must be unique
  pushChannel: "00fc13adff785122b4ad28809a3420982341241421348097878e577c991de8f0", // PNS specific handle
  tags: ["likes_hockey", "likes_football"],
});

installation = await client.createOrUpdateInstallation(installation);

모듈식 접근 방식을 사용하면 코드는 다음과 같습니다.

import { createClientContext, createOrUpdateInstallation } from "@azure/notification-hubs/api";
import { createAppleInstallation } from "@azure/notification-hubs/models";
import { v4 as uuid } from "uuid";

const context = createClientContext("<connection string>", "<hub name>");

// Create an installation for APNs
let installation = createAppleInstallation({
  installationId: uuid(), // Must be unique
  pushChannel: "00fc13adff785122b4ad28809a3420982341241421348097878e577c991de8f0", // PNS specific handle
  tags: ["likes_hockey", "likes_football"],
});

installation = await createOrUpdateInstallation(context, installation);

설치에 대한 업데이트는 메서드를 사용하여 태그 및 사용자 ID 추가와 같은 JSON 패치 스키마를 updateInstallation 통해 수행할 수 있습니다.

import { NotificationHubsClient, JsonPatch } from "@azure/notification-hubs";

const client = new NotificationHubsClient("<connection string>", "<hub name>");

const installationId = "<unique installation ID>";

const updates: JsonPatch[] = [
  { op: "add", path: "/tags", value: "likes_baseball" },
  { op: "add", path: "/userId", value: "bob@contoso.com" },
];

const installation = await client.updateInstallation(installationId, updates);

모듈식 접근 방식을 사용하면 코드는 다음과 같습니다.

import { createClientContext, updateInstallation } from "@azure/notification-hubs/api";
import { JsonPatch } from "@azure/notification-hubs/models";

const context = createClientContext("<connection string>", "<hub name>");

const installationId = "<unique installation ID>";

const updates: JsonPatch[] = [
  { op: "add", path: "/tags", value: "likes_baseball" },
  { op: "add", path: "/userId", value: "bob@contoso.com" },
];

const installation = await updateInstallation(context, installationId, updates);

기존 설치를 검색하려면 기존 고유 설치 ID와 함께 메서드를 사용합니다 getInstallation .

import { NotificationHubsClient } from "@azure/notification-hubs";

const client = new NotificationHubsClient("<connection string>", "<hub name>");

const installationId = "<unique installation ID>";

const installation = client.getInstallation(installationId);

모듈식 접근 방식을 사용하면 코드는 다음과 같습니다.

import { createClientContext, getInstallation } from "@azure/notification-hubs/api";

const context = createClientContext("<connection string>", "<hub name>");

const installationId = "<unique installation ID>";

const installation = getInstallation(context, installationId);

등록 API

등록은 위의 설치와 마찬가지로 PNS의 고유 디바이스 식별자 및 연결된 태그와 함께 PNS와 연결됩니다. 템플릿 등록은 미리 정의된 본문 템플릿을 만드는 방법이며, 전송 시 메시지에 입력할 속성을 사용하여 사용자 지정할 수 있습니다. 템플릿에 대한 자세한 내용은 템플릿 설명서를 참조하세요.

설치는 두 가지 방법 중 하나로 만들 수 있습니다. 먼저 를 사용 getInstallationIdcreateOrUpdateRegistration 하거나 메서드를 통해 서버에서 등록 ID를 createRegistration 가져옵니다.

import {
  NotificationHubsClient,
  createAppleRegistrationDescription,
} from "@azure/notification-hubs";

const client = new NotificationHubsClient("<connection string>", "<hub name>");

let registration = createAppleRegistrationDescription({
  deviceToken: "00fc13adff785122b4ad28809a3420982341241421348097878e577c991de8f0",
  tags: ["likes_hockey", "likes_football"],
});

registration = await client.createRegistration(registration);

console.log(`New Registration ID: ${registration.registrationId}`);

모듈식 접근 방식을 사용하면 코드는 다음과 같습니다.

import { createClientContext, createRegistration } from "@azure/notification-hubs/api";
import { createAppleRegistrationDescription } from "@azure/notification-hubs/models";

const context = createClientContext("<connection string>", "<hub name>");

let registration = createAppleRegistrationDescription({
  deviceToken: "00fc13adff785122b4ad28809a3420982341241421348097878e577c991de8f0",
  tags: ["likes_hockey", "likes_football"],
});

registration = await createRegistration(context, registration);

console.log(`New Registration ID: ${registration.registrationId}`);

업데이트 메서드를 updateRegistration 통해 수행할 수 있지만 설치와 달리 증분 업데이트를 지원하지 않습니다. 기존 등록에 대한 쿼리는 메서드를 getRegistration 사용하여 수행할 수 있습니다.

import { NotificationHubsClient } from "@azure/notification-hubs";

const client = new NotificationHubsClient("<connection string>", "<hub name>");

const registrationId = "<unique Registration ID>";

let registration = await client.getRegistration(registrationId);

registration.tags.push("likes_sports");

registration = await client.updateRegistration(registration);

모듈식 접근 방식을 사용하면 코드는 다음과 같습니다.

import {
  createClientContext,
  getRegistration,
  updateRegistration
} from "@azure/notification-hubs/api";

const context = createClientContext("<connection string>", "<hub name>");

const registrationId = "<unique Registration ID>";

let registration = await getRegistration(context, registrationId);

registration.tags.push("likes_sports");

registration = await updateRegistration(context, registration);

설치와 달리 등록을 쿼리하여 모든 등록, 조건에 일치하는 등록 또는 태그를 가져올 수 있습니다. 등록은 , listRegistrationsByChannel 및 listRegistrationsByTag 메서드를 listRegistrations사용하여 쿼리할 수 있습니다. 모든 메서드는 옵션을 통해 top 제한을 지원하고 비동기 페이징을 지원합니다.

import { NotificationHubsClient } from "@azure/notification-hubs/api";

const client = new NotificationHubsClient("<connection string>", "<hub name>");

const registrations = await client.listRegistrationsByTag("likes_hockey");

let page = 0;
for await (const pages of registrations.byPage()) {
  console.log(`Page number ${page++}`);
  for (const item of pages) {
    console.log(JSON.stringify(item, null, 2));
  }
}

모듈식 접근 방식을 사용하면 코드는 다음과 같습니다.

import { createClientContext, listRegistrationsByTag } from "@azure/notification-hubs/api";

const context = createClientContext("<connection string>", "<hub name>");

const registrations = await listRegistrationsByTag(context, "likes_hockey");

let page = 0;
for await (const pages of registrations.byPage()) {
  console.log(`Page number ${page++}`);
  for (const item of pages) {
    console.log(JSON.stringify(item, null, 2));
  }
}

보내기 작업

Notification Hubs는 고유한 PNS 제공 식별자를 직접 사용하거나, 대상 그룹 보내기에 태그를 사용하거나, 모든 디바이스에 일반 브로드캐스트를 사용하여 디바이스에 알림 보내기를 지원합니다. 표준 SKU 이상을 사용하여 예약된 보내기 를 사용하면 최대 7일 전에 알림을 예약할 수 있습니다. 모든 보내기 작업은 Notification Hubs 지원 사례에 사용할 수 있는 추적 ID 및 상관 관계 ID를 반환합니다. 표준 SKU 이상을 사용하면 메서드를 통해 getNotificationOutcomeDetails 알림 원격 분석을 가져오는 데 사용할 수 있는 알림 ID도 반환됩니다.

디버깅을 위해 메서드의 enableTestSend PNS sendNotification 에서 즉각적인 피드백을 받는 옵션을 설정할 true 수 있지만 프로덕션 시나리오에서는 지원되지 않습니다. 예약된 송신 메서드에서는 지원되지 않습니다.

원시 JSON 또는 XML 문자열을 송신 또는 예약된 송신 메서드로 보내거나 APN, Firebase, Baidu, ADM 및 WNS와 같은 PNS당 메시지를 생성하는 데 도움이 되는 알림 작성기를 사용할 수 있습니다. 이러한 작성기는 네이티브 메시지 형식을 빌드하므로 각 PNS에 사용할 수 있는 필드를 추측하지 않습니다.

// Using the class-based approach
import { createAppleNotificationBody } from "@azure/notification-hubs";

// Using the modular approach
import { createAppleNotification, createAppleNotificationBody } from "@azure/notification-hubs/models";

const apnsBody = createAppleNotificationBody({
  alert: {
    title: "Notification Title",
    subtitle: "Notification Subtitle",
    body: "Notification body goes here",
  },
  sound: "default",
  interruptionLevel: "time-sensitive",
});

// Send the message using the modular approach
const notification = createAppleNotification({
  body: apnsBody
})

const result = await sendNotification(context, notification);

브로드캐스트 보내기

Notification Hubs는 메서드를 통해 sendNotification 브로드캐스트 보내기를 사용하여 플랫폼당 등록된 모든 디바이스에 알림을 보내는 데 사용할 수 있습니다.

import {
  NotificationHubsClient,
  createAppleNotification,
} from "@azure/notification-hubs/api";

const context = createClientContext(connectionString, hubName);

const messageBody = `{ "aps" : { "alert" : "Hello" } }`;

const message = createAppleNotification({
  body: messageBody,
  headers: {
    "apns-priority": "10",
    "apns-push-type": "alert",
  },
});

const result = await client.sendNotification(message);

console.log(`Tracking ID: ${result.trackingId}`);
console.log(`Correlation ID: ${result.correlationId}`);

// Only available in Standard SKU and above
if (result.notificationId) {
  console.log(`Notification ID: ${result.notificationId}`);
}

모듈식 접근 방식을 사용하면 코드는 다음과 같습니다.

import { createClientContext, sendNotification } from "@azure/notification-hubs/api";
import { createAppleNotification } from "@azure/notification-hubs/models";

const context = createClientContext(connectionString, hubName);

const messageBody = `{ "aps" : { "alert" : "Hello" } }`;

const message = createAppleNotification({
  body: messageBody,
  headers: {
    "apns-priority": "10",
    "apns-push-type": "alert",
  },
});

const result = await sendNotification(context, message);

console.log(`Tracking ID: ${result.trackingId}`);
console.log(`Correlation ID: ${result.correlationId}`);

// Only available in Standard SKU and above
if (result.notificationId) {
  console.log(`Notification ID: ${result.notificationId}`);
}

직접 보내기

디바이스를 직접 보내기 위해 사용자는 매개 변수를 사용하여 메서드 deviceHandle 를 호출 sendNotification 하여 APNs 디바이스 토큰과 같은 플랫폼 제공 고유 식별자를 사용하여 보낼 수 있습니다.

import {
  NotificationHubsClient,
  createAppleNotification,
} from "@azure/notification-hubs";

const client = new NotificationHubsClient(connectionString, hubName);

const deviceHandle = "00fc13adff785122b4ad28809a3420982341241421348097878e577c991de8f0";
const messageBody = `{ "aps" : { "alert" : "Hello" } }`;

const message = createAppleNotification({
  body: messageBody,
  headers: {
    "apns-priority": "10",
    "apns-push-type": "alert",
  },
});

const result = await client.sendNotification(message, { deviceHandle });

console.log(`Tracking ID: ${result.trackingId}`);
console.log(`Correlation ID: ${result.correlationId}`);

// Only available in Standard SKU and above
if (result.notificationId) {
  console.log(`Notification ID: ${result.notificationId}`);
}

모듈식 접근 방식을 사용하면 코드는 다음과 같습니다.

import { createClientContext, sendDirectNotification } from "@azure/notification-hubs/api";
import { createAppleNotification } from "@azure/notification-hubs/models";

const context = createClientContext(connectionString, hubName);

const deviceHandle = "00fc13adff785122b4ad28809a3420982341241421348097878e577c991de8f0";
const messageBody = `{ "aps" : { "alert" : "Hello" } }`;

const message = createAppleNotification({
  body: messageBody,
  headers: {
    "apns-priority": "10",
    "apns-push-type": "alert",
  },
});

const result = await sendNotification(context, message, { deviceHandle });

console.log(`Tracking ID: ${result.trackingId}`);
console.log(`Correlation ID: ${result.correlationId}`);

// Only available in Standard SKU and above
if (result.notificationId) {
  console.log(`Notification ID: ${result.notificationId}`);
}

대상 그룹 보내기

사용자는 단일 디바이스를 대상으로 하는 것 외에도 태그를 사용하여 여러 디바이스를 대상으로 지정할 수 있습니다. 이러한 태그는 태그 목록으로 제공될 수 있으며, 그러면 등록된 디바이스와 일치하도록 태그 식을 만들거나 태그 식을 통해 제공될 수 있으며, 태그 식을 통해 부울 논리를 사용하여 올바른 대상 그룹을 대상으로 지정할 수 있습니다. 태그 및 태그 식에 대한 자세한 내용은 라우팅 및 태그 식을 참조하세요.

태그 배열에서 태그 식을 만들려는 경우 태그에서 "또는 태그 식"을 만드는 최상위 가져오기 또는 @azure/notification-hubs/models/tagExpressionBuilder 모듈식 가져오기에 노출되는 메서드와 함께 createTagExpression 사용할 수 있는 태그 식 작성기가 있습니다.

// Top level import
import { createTagExpression } from "@azure/notification-hubs";

// Modular import
import { createTagExpression } from "@azure/notification-hubs/models";

const tags = ["likes_football", "likes_hockey"];
const tagExpression = createTagExpression(tags);

console.log(tagExpression);
// likes_football||likes_hockey

태그 식 메시지는 다음 코드를 사용하여 보낼 수 있습니다.

import {
  NotificationHubsClient,
  createAppleNotification,
} from "@azure/notification-hubs";

const client = new NotificationHubsClient("<connection string>", "<hub name>");

const tagExpression = "likes_hockey && likes_football";
const messageBody = `{ "aps" : { "alert" : "Hello" } }`;

const notification = createAppleNotification({
  body: messageBody,
  headers: {
    "apns-priority": "10",
    "apns-push-type": "alert",
  },
});

const result = await client.sendNotification(notification, { tagExpression });

console.log(`Tracking ID: ${result.trackingId}`);
console.log(`Correlation ID: ${result.correlationId}`);

// Only available in Standard SKU and above
if (result.notificationId) {
  console.log(`Notification ID: ${result.notificationId}`);
}

모듈식 접근 방식을 사용하면 코드는 다음과 같습니다.

import { createClientContext, sendNotification } from "@azure/notification-hubs/api";
import { createAppleNotification } from "@azure/notification-hubs/models";

const context = createClientContext("<connection string>", "<hub name>");

const tagExpression = "likes_hockey && likes_football";
const messageBody = `{ "aps" : { "alert" : "Hello" } }`;

const notification = createAppleNotification({
  body: messageBody,
  headers: {
    "apns-priority": "10",
    "apns-push-type": "alert",
  },
});

const result = await sendNotification(context, notification, { tagExpression });

console.log(`Tracking ID: ${result.trackingId}`);
console.log(`Correlation ID: ${result.correlationId}`);

// Only available in Standard SKU and above
if (result.notificationId) {
  console.log(`Notification ID: ${result.notificationId}`);
}

예약된 보내기

푸시 알림은 태그 또는 일반 브로드캐스트가 있는 디바이스에 보내는 방법을 사용하여 scheduleBroadcastNotification 표준 SKU 네임스페이스 이상에서 최대 7일 전에 예약할 수 있습니다. 그러면 메서드를 통해 필요한 경우 취소하는 데 사용할 수 있는 알림 ID가 반환됩니다 cancelScheduledNotification .

import {
  NotificationHubsClient,
  createAppleNotification,
} from "@azure/notification-hubs";

const client = new NotificationHubsClient("<connection string>", "<hub name>");

const tagExpression = "likes_hockey && likes_football";
const messageBody = `{ "aps" : { "alert" : "Hello" } }`;

// Schedule 8 hours from now
const scheduledTime = new Date(Date.now() + (8 * 60 * 60 * 1000));

const message = createAppleNotification({
  body: messageBody,
  headers: {
    "apns-priority": "10",
    "apns-push-type": "alert",
  },
});

const result = await client.scheduleNotification(scheduledTime, message, { tagExpression });

console.log(`Tracking ID: ${result.trackingId}`);
console.log(`Correlation ID: ${result.correlationId}`);

// Can be used to cancel via the cancelScheduledSend method
console.log(`Notification ID: ${result.notificationId}`);

모듈식 접근 방식을 사용하면 코드는 다음과 같습니다.

import { createClientContext, scheduleNotification } from "@azure/notification-hubs/api";
import { createAppleNotification } from "@azure/notification-hubs/models";

const context = createClientContext("<connection string>", "<hub name>");

const tagExpression = "likes_hockey && likes_football";
const messageBody = `{ "aps" : { "alert" : "Hello" } }`;

// Schedule 8 hours from now
const scheduledTime = new Date(Date.now() + (8 * 60 * 60 * 1000));

const message = createAppleNotification({
  body: messageBody,
  headers: {
    "apns-priority": "10",
    "apns-push-type": "alert",
  },
});

const result = await scheduleNotification(context, scheduledTime, message, { tagExpression });

console.log(`Tracking ID: ${result.trackingId}`);
console.log(`Correlation ID: ${result.correlationId}`);

// Can be used to cancel via the cancelScheduledSend method
console.log(`Notification ID: ${result.notificationId}`);

문제 해결

React Native 지원

React Native 현재 Azure Notification Hubs SDK에서 사용되는 [URLSearchParams]을 지원하지 않습니다. React Native SDK를 사용하려면 SDK를 url-search-params-polyfill 사용하기 전에 패키지를 설치하고 가져와야 합니다.

import 'url-search-params-polyfill';

또한 API 및 비동기 반복기 API에 대한 TextEncoder 폴리필을 제공해야 합니다. 자세한 내용은 Expo의 React Native 샘플을 참조하세요.

삭제된 알림 진단

Azure Notification Hubs에는 Azure Notification Hubs 가이드의 삭제된 알림 진단에서 삭제된 알림 문제를 해결하는 전체 가이드가 있습니다.

테스트 전송은 다음 옵션을 사용하여 메서드에서 sendNotification 지원됩니다.enableTestSend

// Using the client
const result = await client.sendNotification(notification, { tags, enableTestSend: true });

// Using the modular approach
const result = await sendNotification(context, notification, { tags, enableTestSend: true });

로깅

로깅을 사용하도록 설정하면 실패에 대한 유용한 정보를 파악하는 데 도움이 될 수 있습니다. HTTP 요청 및 응답 로그를 보려면 AZURE_LOG_LEVEL 환경 변수를 info로 설정합니다. 또는 @azure/logger에서 setLogLevel을 호출하여 런타임에 로깅을 사용하도록 설정할 수 있습니다.

const { setLogLevel } = require("@azure/logger");

setLogLevel("info");

로그를 사용하는 방법에 대한 자세한 내용은 @azure/logger package docs를 참조하세요.

다음 단계

다음 샘플에서는 Azure Notification Hubs와 상호 작용할 수 있는 다양한 방법을 보여 줍니다.

장치 관리:

• 설치 API
  • Create 또는 업데이트 설치
  • 설치 업데이트
• 등록 API
  • Create 등록
  • Create 또는 업데이트 등록
  • 등록 업데이트
  • 등록 나열
  • 태그별 등록 나열

보내기 작업:

• 브로드캐스트 보내기
• 직접 보내기
• 태그 목록을 사용하여 대상 그룹 보내기
• 태그 식을 사용하여 대상 그룹 보내기
• 예약된 브로드캐스트 보내기
• 예약된 보내기

관리 작업:

• 등록 내보내기
• 등록 가져오기

참여

이 라이브러리에 기여하려면 기여 가이드 를 참조하여 코드를 빌드하고 테스트하는 방법에 대해 자세히 알아보세요.

이 모듈의 테스트는 라이브 및 단위 테스트가 혼합되어 있으므로 Azure Notification Hubs instance 있어야 합니다. 테스트를 실행하려면 다음을 실행해야 합니다.

1. rush update
2. rush build -t @azure/notification-hubs
3. 폴더에 다음 내용이 포함된 .env 파일을 Create.sdk\notificationhubs\notification-hubsNOTIFICATIONHUBS_CONNECTION_STRING=connection string for your Notification Hubs instanceNOTIFICATION_HUB_NAME=Notification Hub name
4. cd sdk\notificationhubs\notification-hubs
5. rushx test.

자세한 내용은 tests 폴더를 참조하세요.

관련된 프로젝트

• JavaScript용 Microsoft Azure SDK
• Azure Notification Hubs