プッシュ通知ウィザードにより生成されるコード

Visual Studio でウィザードを使うことで、Azure のモバイル サービスで作成されたモバイル サービスからプッシュ通知を生成できます。Visual Studio ウィザードにより、この作業に役立つコードが生成されます。このトピックでは、ウィザードによるプロジェクトの変更内容、生成されたコードによる実行内容、このコードを使う方法、プッシュ通知を最大限に活用するために次に行うことができる作業について説明します。「Windows プッシュ通知サービス (WNS) の概要」をご覧ください。

ウィザードによるプロジェクトの変更内容

プッシュ通知ウィザードは、次のようにプロジェクトを変更します。

  • モバイル サービスの管理されたクライアントへの参照を追加します (MobileServicesManagedClient.dll)。JavaScript プロジェクトには当てはまりません。
  • サービスの下にあるサブフォルダーにファイルを追加し、ファイルに push.register.cs、push.register.vb、push.register.cpp、または push.register.js という名前を付けます。
  • モバイル サービスのデータベース サーバーでチャネル テーブルを作成します。テーブルには、アプリ インスタンスにプッシュ通知を送るために必要な情報が格納されます。
  • 4 つの機能 (削除、挿入、読み取り、更新) のスクリプトを作成します。
  • カスタム API を含むスクリプト notifyallusers.js を作成します。この API は、すべてのクライアントにプッシュ通知を送ります。
  • App.xaml.cs、App.xaml.vb、または App.xaml.cpp ファイルに宣言を追加したり、JavaScript プロジェクトの新しいファイルである service.js に宣言を追加したりします。 宣言では、モバイル サービスへの接続に必要な情報を含む MobileServiceClient オブジェクトが宣言されます。App.MyServiceNameClient という名前を使って、アプリ内のどのページからでも MyServiceNameClient という名前のこの MobileServiceClient オブジェクトにアクセスできます。

services.js ファイルには、次のコードが含まれています。



var <mobile-service-name>Client = new Microsoft.WindowsAzure.MobileServices.MobileServiceClient(
                "https://<mobile-service-name>.azure-mobile.net/",
                "<your client secret>");

プッシュ通知への登録

push.register.* 内の UploadChannel メソッドは、プッシュ通知を受信するデバイスを登録します。Windows ストアは、アプリのインストールされたインスタンスを追跡し、プッシュ通知チャネルを提供します。 「PushNotificationChannelManager」をご覧ください。

クライアント コードは、JavaScript のバックエンドと .NET のバックエンドの両方に似ています。既定では、JavaScript バックエンド サービスのプッシュ通知を追加すると、notifyAllUsers カスタム API のサンプル呼び出しが UploadChannel メソッドに挿入されます。



(function () {
    "use strict";

    var app = WinJS.Application;
    var activation = Windows.ApplicationModel.Activation;

    app.addEventListener("activated", function (args) {
        if (args.detail.kind == activation.ActivationKind.launch) {
            Windows.Networking.PushNotifications.PushNotificationChannelManager.createPushNotificationChannelForApplicationAsync()
                .then(function (channel) {
                    mymobileserviceclient1234Client.push.registerNative(channel.Uri, new Array("tag1", "tag2"))
                    return mymobileservice1234Client.push.registerNative(channel.uri);
                })
                .done(function (registration) {
                    return mymobileservice1234Client.invokeApi("notifyAllUsers");
                }, function (error) {
                    // Error

                });
        }
    });
})();


プッシュ通知のタグがクライアントのサブセットへの通知を制限する方法を提供します。registerNative メソッド (または RegisterNativeAsync) メソッドを使って、タグを指定せずにすべてのプッシュ通知に登録するか、2 番目の引数としてタグの配列を指定することによって、タグを指定して登録できます。1 つまたは複数のタグを登録すると、タグに一致する通知のみを受け取ります。

サーバー側のスクリプト (JavaScript バックエンドのみ)

JavaScript バックエンドを使うモバイル サービスの場合、サーバー側のスクリプトは、削除、挿入、読み取り、または更新操作が行われたときに実行されます。スクリプトにはこれらの操作が実装されていませんが、クライアントから Windows モバイルの REST API への呼び出しによってこれらのイベントがトリガーされると実行されます。次に、スクリプトは request.execute または request.respond を呼び出して呼び出し元コンテキストに応答を発行することで、コントロールを操作自体に渡します。「Azure のモバイル サービスの REST API リファレンス」をご覧ください。

サーバー側のスクリプトでは、さまざまな関数を使うことができます。「Azure のモバイル サービスでのテーブル操作の登録」をご覧ください。使用できる関数のリファレンスについては、「Mobile Services サーバーのスクリプトのリファレンス」をご覧ください。

また、Notifyallusers.js に次のカスタム API コードが作成されます。



exports.post = function(request, response) {
    response.send(statusCodes.OK,{ message : 'Hello World!' })
    
    // The following call is for illustration purpose only
    // The call and function body should be moved to a script in your app
    // where you want to send a notification
    sendNotifications(request);
};

// The following code should be moved to appropriate script in your app where notification is sent
function sendNotifications(request) {
    var payload = '<?xml version="1.0" encoding="utf-8"?><toast><visual><binding template="ToastText01">' +
        '<text id="1">Sample Toast</text></binding></visual></toast>';
    var push = request.service.push; 
    push.wns.send(null,
        payload,
        'wns/toast', {
            success: function (pushResponse) {
                console.log("Sent push:", pushResponse);
            }
        });
}

sendNotifications 関数は、1 つの通知をトースト通知として送信します。他の種類のプッシュ通知を使うこともできます。

ヒント  スクリプトの編集中にヘルプを表示する方法については、サーバー側の JavaScript で IntelliSense を有効にする方法に関するページをご覧ください。

プッシュ通知の種類

Windows では、プッシュ通知ではない通知がサポートされています。通知に関する一般情報については、「スケジュールされた通知、定期的な通知、プッシュ通知の送信」をご覧ください。

トースト通知は使いやすく、自動的に生成されるチャネル テーブルの Insert.js コードで例を確認できます。タイル通知かバッジ通知を使う予定の場合、タイルとバッジの XML テンプレートを作成し、テンプレートでパッケージ化された情報のエンコードを指定する必要があります。「タイル、バッジ、トースト通知の操作」をご覧ください。

Windows は、プッシュ通知に応答するため、アプリが実行されていないときにこれらの通知のほとんどを処理できます。たとえば、プッシュ通知は、ローカル メール アプリが実行されていないときでも新しいメール メッセージを受信したことをユーザーに知らせることができます。Windows は、テキスト メッセージの先頭行のようなメッセージを表示することで、トースト通知を処理します。Windows は、ライブ タイルを更新して新しいメール メッセージの数を反映することで、タイル通知またはバッジ通知を処理します。このように、新しい情報をチェックするように促すプロンプトをアプリのユーザーに表示できます。アプリは、実行中に直接通知を受け取ることができるため、直接通知を使ってアプリにデータを送ることができます。アプリが実行されていない場合、プッシュ通知を監視するバックグラウンド タスクを設定できます。

プッシュ通知は、ユーザーのリソースを消費し、使いすぎると煩わしくなる場合があるため、Windows ストア アプリのガイドラインに従って使ってください。「プッシュ通知のガイドラインとチェック リスト」をご覧ください。

プッシュ通知でライブ タイルを更新する場合は、「タイルとバッジのガイドラインとチェック リスト」のガイドラインにも従ってください。

次のステップ

WNS の使用

モバイル サービスの柔軟性が不十分な場合、C# または Visual Basic でサーバー コードを記述する場合、または既にクラウド サービスを持っていてそこからプッシュ通知を送る場合は、WNS を直接呼び出すこともできます。WNS を直接呼び出すことで、データベースや他の Web サービスからのデータを監視するワーカーの役割など、独自のクラウド サービスからプッシュ通知を送ることができます。クラウド サービスがプッシュ通知をアプリに送るには、WNS に対して認証する必要があります。Windows プッシュ通知サービスに対して認証する方法 (JavaScript) または (C#/C++/VB) に関するページをご覧ください。

モバイル サービスでスケジュール済みタスクを実行して、プッシュ通知を送ることもできます。「Mobile Services での繰り返し発生するジョブのスケジュール」をご覧ください。

警告  プッシュ通知ウィザードは 1 回だけ実行してください。もう一度実行して、別のモバイル サービスの登録コードを追加しないようにしてください。このウィザードをプロジェクトごとに複数回実行すると、生成されるコードで CreatePushNotificationChannelForApplicationAsync メソッドの呼び出しが重複し、ランタイムの例外が発生します。複数のモバイル サービスのプッシュ通知を登録するには、ウィザードを 1 回だけ実行し、登録コードを上書きして、CreatePushNotificationChannelForApplicationAsync の呼び出しが同時に実行されないようにしてください。そのために、ウィザードによって push.register.* に生成されたコード (CreatePushNotificationChannelForApplicationAsync の呼び出しを含む) を OnLaunched イベント以外の場所に移すという方法もありますが、細かい処理はアプリのアーキテクチャによって異なります。

関連トピック

WNS の概要
直接通知の概要
Window Azure のモバイル サービスへの接続 (JavaScript)
Window Azure のモバイル サービスへの接続 (C#/C++/VB)
クイック スタート: モバイル サービスでのプッシュ通知の追加 (JavaScript)

 

 

表示:
© 2015 Microsoft