implementation 'com.microsoft.azure:notification-hubs-android-sdk:0.6@aar'
implementation 'com.microsoft.azure:azure-notifications-handler:1.0.1@aar'
在 dependencies 节的后面添加以下存储库。
repositories {
maven {
url "https://dl.bintray.com/microsoftazuremobile/SDK"
为了避免列表冲突，请在项目的 Manifest.xml 文件中添加以下代码：
<manifest package="YOUR.PACKAGE.NAME"
xmlns:tools="http://schemas.android.com/tools"
xmlns:android="http://schemas.android.com/apk/res/android">
然后在 <application/> 标记中执行以下操作：
<application
tools:replace="android:allowBackup,icon,theme,label">
下载并解压缩百度推送 Android SDK。 复制 libs 文件夹中的 pushservice-x.y.z jar 文件。 然后复制 Android 应用程序的 .so（创建新文件夹）文件夹中的 src/main/jniLibs 文件。
打开 Android 项目的 AndroidManifest.xml 文件，添加百度 SDK 所需的权限。
将 YOURPACKAGENAME 替换为包名。
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
<uses-permission android:name="android.permission.WRITE_SETTINGS" />
<uses-permission android:name="android.permission.VIBRATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.DISABLE_KEYGUARD" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_DOWNLOAD_MANAGER" />
<uses-permission android:name="android.permission.DOWNLOAD_WITHOUT_NOTIFICATION" />
<uses-permission android:name="android.permission.EXPAND_STATUS_BAR" />
!! <uses-permission android:name="baidu.push.permission.WRITE_PUSHINFOPROVIDER.YOURPACKAGENAME" />
!!<permission android:name="baidu.push.permission.WRITE_PUSHINFOPROVIDER.YOURPACKAGENAME" android:protectionLevel="normal" />
在 .MainActivity 活动元素后的 application 元素内添加以下配置，并替换 yourprojectname（例如 com.example.BaiduTest）：
<activity
android:name="com.baidu.android.pushservice.richmedia.MediaViewActivity"
android:configChanges="orientation|keyboardHidden"
android:label="MediaViewActivity" />
<activity
android:name="com.baidu.android.pushservice.richmedia.MediaListActivity"
android:configChanges="orientation|keyboardHidden"
android:label="MediaListActivity"
android:launchMode="singleTask" />
<!-- Push application definition message -->
<receiver android:name=".MyPushMessageReceiver">
<intent-filter>
<!-- receive push message-->
<action android:name="com.baidu.android.pushservice.action.MESSAGE" />
<!-- receive bind,unbind,fetch,delete.. message-->
<action android:name="com.baidu.android.pushservice.action.RECEIVE" />
<action android:name="com.baidu.android.pushservice.action.notification.CLICK" />
</intent-filter>
</receiver>
<receiver
android:name="com.baidu.android.pushservice.PushServiceReceiver"
android:process=":bdservice_v1">
<intent-filter>
<action android:name="android.intent.action.BOOT_COMPLETED" />
<action android:name="android.net.conn.CONNECTIVITY_CHANGE" />
<action android:name="com.baidu.android.pushservice.action.notification.SHOW" />
<action android:name="com.baidu.android.pushservice.action.media.CLICK" />
<action android:name="android.intent.action.MEDIA_MOUNTED" />
<action android:name="android.intent.action.USER_PRESENT" />
<action android:name="android.intent.action.ACTION_POWER_CONNECTED" />
<action android:name="android.intent.action.ACTION_POWER_DISCONNECTED" />
</intent-filter>
</receiver>
<receiver
android:name="com.baidu.android.pushservice.RegistrationReceiver"
android:process=":bdservice_v1">
<intent-filter>
<action android:name="com.baidu.android.pushservice.action.METHOD" />
<action android:name="com.baidu.android.pushservice.action.BIND_SYNC" />
</intent-filter>
<intent-filter>
<action android:name="android.intent.action.PACKAGE_REMOVED" />
<data android:scheme="package" />
</intent-filter>
</receiver>
<service
android:name="com.baidu.android.pushservice.PushService"
android:exported="true"
android:process=":bdservice_v1">
<intent-filter>
<action android:name="com.baidu.android.pushservice.action.PUSH_SERVICE" />
</intent-filter>
</service>
<service
android:name="com.baidu.android.pushservice.CommandService"
android:exported="true" />
<!-- Adapt the ContentProvider declaration required for the Android N system, and the write permissions include the application package name-->
<provider
android:name="com.baidu.android.pushservice.PushInfoProvider"
android:authorities="com.baidu.push.example.bdpush"
android:exported="true"
android:protectionLevel="signature"
android:writePermission="baidu.push.permission.WRITE_PUSHINFOPROVIDER. yourprojectname " />
<!-- API Key of the Baidu application -->
<meta-data
android:name="api_key"
!! android:value="api_key" />
</application>
将名为 ConfigurationSettings.java 的新类添加到项目。
public class ConfigurationSettings {
public static String API_KEY = "...";
public static String NotificationHubName = "...";
public static String NotificationHubConnectionString = "...";
使用百度云项目中的 API_KEY 设置 API_KEY 字符串的值。
使用 NotificationHubName中的通知中心名称设置 字符串的值，然后使用 NotificationHubConnectionString中的 DefaultListenSharedAccessSignature 设置 的值。
打开 MainActivity.java，并将以下内容添加到 onCreate 方法中：
PushManager.startWork(this, PushConstants.LOGIN_TYPE_API_KEY, API_KEY );
添加一个名为 MyPushMessageReceiver.java 的新类，并向此类中添加以下代码： 此类用于处理从百度推送服务器收到的推送通知。
package your.package.name;
import android.content.Context;
import android.content.Intent;
import android.os.AsyncTask;
import android.text.TextUtils;
import android.util.Log;
import com.baidu.android.pushservice.PushMessageReceiver;
import com.microsoft.windowsazure.messaging.NotificationHub;
import org.json.JSONException;
import org.json.JSONObject;
import java.util.List;
public class MyPushMessageReceiver extends PushMessageReceiver {
public static final String TAG = MyPushMessageReceiver.class
.getSimpleName();
public static NotificationHub hub = null;
public static String mChannelId, mUserId;
@Override
public void onBind(Context context, int errorCode, String appid,
String userId, String channelId, String requestId) {
String responseString = "onBind errorCode=" + errorCode + " appid="
+ appid + " userId=" + userId + " channelId=" + channelId
+ " requestId=" + requestId;
Log.d(TAG, responseString);
if (errorCode == 0) {
// Binding successful
Log.d(TAG, " Binding successful");
try {
if (hub == null) {
hub = new NotificationHub(
ConfigurationSettings.NotificationHubName,
ConfigurationSettings.NotificationHubConnectionString,
context);
Log.i(TAG, "Notification hub initialized");
} catch (Exception e) {
Log.e(TAG, e.getMessage());
mChannelId = channelId;
mUserId = userId;
registerWithNotificationHubs();
private void registerWithNotificationHubs() {
new AsyncTask<Void, Void, Void>() {
@Override
protected Void doInBackground(Void... params) {
try {
hub.registerBaidu(mUserId, mChannelId);
Log.i(TAG, "Registered with Notification Hub - '"
+ ConfigurationSettings.NotificationHubName + "'"
+ " with UserId - '"
+ mUserId + "' and Channel Id - '"
+ mChannelId + "'");
} catch (Exception e) {
Log.e(TAG, e.getMessage());
return null;
}.execute(null, null, null);
@Override
public void onMessage(Context context, String message,
String customContentString) {
String messageString = " onMessage=\"" + message
+ "\" customContentString=" + customContentString;
Log.d(TAG, messageString);
if (!TextUtils.isEmpty(customContentString)) {
JSONObject customJson = null;
try {
customJson = new JSONObject(customContentString);
String myvalue = null;
if (!customJson.isNull("mykey")) {
myvalue = customJson.getString("mykey");
} catch (JSONException e) {
e.printStackTrace();
@Override
public void onNotificationArrived(Context context, String title, String description, String customContentString) {
String notifyString = " Notice Arrives onNotificationArrived title=\"" + title
+ "\" description=\"" + description + "\" customContent="
+ customContentString;
Log.d(TAG, notifyString);
if (!TextUtils.isEmpty(customContentString)) {
JSONObject customJson = null;
try {
customJson = new JSONObject(customContentString);
String myvalue = null;
if (!customJson.isNull("mykey")) {
myvalue = customJson.getString("mykey");
} catch (JSONException e) {
// TODO Auto-generated catch block
e.printStackTrace();
@Override
public void onNotificationClicked(Context context, String title, String description, String customContentString) {
String notifyString = " onNotificationClicked title=\"" + title + "\" description=\""
+ description + "\" customContent=" + customContentString;
Log.d(TAG, notifyString);
Intent intent = new Intent(context.getApplicationContext(),MainActivity.class);
intent.putExtra("title",title);
intent.putExtra("description",description);
intent.putExtra("isFromNotify",true);
intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
context.getApplicationContext().startActivity(intent);
@Override
public void onSetTags(Context context, int errorCode,
List<String> successTags, List<String> failTags, String requestId) {
String responseString = "onSetTags errorCode=" + errorCode
+ " successTags=" + successTags + " failTags=" + failTags
+ " requestId=" + requestId;
Log.d(TAG, responseString);
@Override
public void onDelTags(Context context, int errorCode,
List<String> successTags, List<String> failTags, String requestId) {
String responseString = "onDelTags errorCode=" + errorCode
+ " successTags=" + successTags + " failTags=" + failTags
+ " requestId=" + requestId;
Log.d(TAG, responseString);
@Override
public void onListTags(Context context, int errorCode, List<String> tags,
String requestId) {
String responseString = "onListTags errorCode=" + errorCode + " tags="
+ tags;
Log.d(TAG, responseString);
@Override
public void onUnbind(Context context, int errorCode, String requestId) {
String responseString = "onUnbind errorCode=" + errorCode
+ " requestId = " + requestId;
Log.d(TAG, responseString);
if (errorCode == 0) {
// Unbinding is successful
Log.d(TAG, " Unbinding is successful ");
向应用程序发送通知
使用通知中心配置屏幕中的发送按钮，可以在 Azure 门户中快速测试通知接收情况，如以下屏幕所示：
通常，推送通知是在后端服务（例如，移动服务，或者使用兼容库的 ASP.NET）中发送的。 如果后端没有可用的库，则可直接使用 REST API 发送通知消息。
为简单起见，本教程使用一个控制台应用演示如何通过 .NET SDK 来发送通知。 但是，建议你接下来学习使用通知中心向用户推送通知教程，了解如何从 ASP.NET 后端发送通知。
下面是用于发送通知的不同方法：
REST 接口：可以使用 REST 接口在任何后端平台上支持通知。
Azure 通知中心 .NET SDK：在 Visual Studio 的 NuGet 包管理器中，运行 Install-Package Microsoft.Azure.NotificationHubs。
Node.js：如何通过 Node.js 使用通知中心。
移动应用：有关如何从通知中心集成的 Azure 应用服务移动应用后端发送通知的示例，请参阅将推送通知添加到移动应用。
Java/PHP：有关如何使用 REST API 发送通知的示例，请参阅“如何通过 Java/PHP 使用通知中心”(Java | PHP)。
（可选）通过 .NET 控制台应用发送通知。
在本部分，我们演示如何使用 .NET 控制台应用发送通知。
创建新的 Visual C# 控制台应用程序：
在“包管理器控制台”窗口中，将默认项目设置为新的控制台应用程序项目，并在控制台窗口中执行以下命令：
Install-Package Microsoft.Azure.NotificationHubs
此指令会使用 Microsoft.Azure.Notification Hubs NuGet 包添加对 Azure 通知中心 SDK 的引用。
在 Program 类中添加以下方法，并使用自己的值替换 DefaultFullSharedAccessSignatureSASConnectionString 和 NotificationHubName。
private static async void SendNotificationAsync()
NotificationHubClient hub = NotificationHubClient.CreateClientFromConnectionString("DefaultFullSharedAccessSignatureSASConnectionString", "NotificationHubName");
string message = "{\"title\":\"((Notification title))\",\"description\":\"Hello from Azure\"}";
var result = await hub.SendBaiduNativeNotificationAsync(message);
在 Main 方法中添加以下行：
SendNotificationAsync();
Console.ReadLine();
测试应用程序
要使用实际的手机测试此应用，只需使用 USB 电缆将该手机连接到你的计算机。 此操作会将应用加载到连接的手机中。
若要使用模拟器测试此应用，请在 Android Studio 顶部工具栏中单击运行，然后选择用于启动模拟器、加载和运行应用的应用。
该应用将从百度推送通知服务检索 userId 和 channelId，并注册到通知中心。
若要发送测试通知，可以使用 Azure 门户的调试选项卡。 如果为 Visual Studio 生成了 .NET 控制台应用程序，只需在 Visual Studio 中按 F5 键以运行该应用程序。 该应用程序会发送一条通知，该通知显示在设备或模拟器的顶部通知区域。
