一、别名（alias）介绍
（1）我们可以给每一个安装了应用程序的用户，取不同别名来标识（比如可以使用用户账号的 userid 来作为别名）。
（2）以后给某个特定用户推送消息时，就可以用此别名来指定。
（2）以后给某个特定用户推送消息时，就可以用此别名来指定。
（3）每个用户只能指定一个别名。所以同一个设备，新设置的别名会覆盖旧的。
（4）如果要删除已有的别名，只要将别名设置为空字符串即可。
（5）系统不限定一个别名只能指定一个用户。如果一个别名被指定到了多个用户，当给指定这个别名发消息时，服务器端API会同时给这多个用户发送消息。
二、别名使用要求
（1）有效的别名组成：字母（区分大小写）、数字、下划线、汉字。
（2）限制：alias 命名长度限制为 40 字节。（判断长度需采用 UTF-8 编码）
三、别名使用的样例说明
下面是一个给指定用户发送消息的样例。
下面是一个给指定用户发送消息的样例。
1，iOS客户端界面
客户端在启动后，我们可以在输入框中填写 alias 别名，点击“注册别名”按钮后，便调用 API 将该设备与这个别名关联起来。
注意：这么做只是为了演示而已，实际项目中应该是 App 在后台就自动去注册别名（比如在登录成功后），而不是由用户去干预。
注意：这么做只是为了演示而已，实际项目中应该是 App 在后台就自动去注册别名（比如在登录成功后），而不是由用户去干预。
2，服务端界面
我们输入别名、消息文本，点击“推送”按钮后，即可给指定的用户发送消息。
3，客户端显示效果
可以看到使用该别名的设备能收到消息，而其他的设备是收不到的。
四、完整代码
1，客户端代码
（1）AppDelegate.swift（这个同之前文章里的一样，没有改变。本文代码已升级至 Swfit3）
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
|
import UIKit
@UIApplicationMainclass AppDelegate: UIResponder, UIApplicationDelegate {
var window: UIWindow?
func application(_ application: UIApplication,
didFinishLaunchingWithOptions
launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
//通知类型（这里将声音、消息、提醒角标都给加上）
let userSettings = UIUserNotificationSettings(types: [.alert, .badge, .sound],
categories: nil)
if ((UIDevice.current.systemVersion as NSString).floatValue >= 8.0) {
//可以添加自定义categories
JPUSHService.register(forRemoteNotificationTypes: userSettings.types.rawValue,
categories: nil)
}
else {
//categories 必须为nil
JPUSHService.register(forRemoteNotificationTypes: userSettings.types.rawValue,
categories: nil)
}
// 启动JPushSDK
JPUSHService.setup(withOption: nil, appKey: "7b96331738ea713195698fd",
channel: "Publish Channel", apsForProduction: false)
return true
}
func application(_ application: UIApplication,
didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
//注册 DeviceToken
JPUSHService.registerDeviceToken(deviceToken)
}
func application(_ application: UIApplication,
didReceiveRemoteNotification userInfo: [AnyHashable : Any],
fetchCompletionHandler
completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
//增加IOS 7的支持
JPUSHService.handleRemoteNotification(userInfo)
completionHandler(UIBackgroundFetchResult.newData)
}
func application(_ application: UIApplication,
didFailToRegisterForRemoteNotificationsWithError error: Error) {
//可选
NSLog("did Fail To Register For Remote Notifications With Error: \(error)")
}
//..........
} |
（2）ViewController.swift（别名注册相关）
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
|
import UIKit
class ViewController: UIViewController {
@IBOutlet weak var textField: UITextField!
@IBOutlet weak var textView: UITextView!
override func viewDidLoad() {
super.viewDidLoad()
}
//按钮点击
@IBAction func btnTouchUp(_ sender: AnyObject) {
//获取别名
let alias = textField.text
//注册别名
JPUSHService.setAlias(alias,
callbackSelector: #selector(tagsAliasCallBack(resCode:tags:alias:)),
object: self)
}
//别名注册回调
func tagsAliasCallBack(resCode:CInt, tags:NSSet, alias:NSString) {
textView.text = "响应结果：\(resCode)"
}
override func didReceiveMemoryWarning() {
super.didReceiveMemoryWarning()
}
} |
2，服务端代码（index.php）
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
|
<?//引入代码require 'JPush/autoload.php';
use JPush\Client as JPush;
if(isset($_POST["message"])){
//初始化
$app_key = "7b528338438ec719495768fd";
$master_secret = "32da4a2c06d27b26d12c5628";
$client = new JPush($app_key, $master_secret);
//简单的推送样例
$result = $client->push()
->setPlatform('ios', 'android')
->addAlias($_POST["alias"])
->setNotificationAlert($_POST["message"])
->options(array(
"apns_production" => true //true表示发送到生产环境(默认值)，false为开发环境
))
->send();
echo 'Result=' . json_encode($result);
}?><html> <head>
</head>
<body>
<form action="index.php" method="post">
别名：<input type="text" name="alias"/><br>
消息：<input type="text" name="message"/>
<button type="submit">推送广播通知</button>
</form>
</body>
</html> |
http://www.hangge.com/blog/cache/detail_1268.html