一、别名(alias)介绍
(4)如果要删除已有的别名,只要将别名设置为空字符串即可。
(5)系统不限定一个别名只能指定一个用户。如果一个别名被指定到了多个用户,当给指定这个别名发消息时,服务器端API会同时给这多个用户发送消息。
二、别名使用要求
(1)有效的别名组成:字母(区分大小写)、数字、下划线、汉字。
(2)限制:alias 命名长度限制为 40 字节。(判断长度需采用 UTF-8 编码)
三、别名使用的样例说明
下面是一个给指定用户发送消息的样例。
(2)ViewController.swift(别名注册相关)
2,服务端代码(index.php)
http://www.hangge.com/blog/cache/detail_1268.html
(1)我们可以给每一个安装了应用程序的用户,取不同别名来标识(比如可以使用用户账号的 userid 来作为别名)。
(2)以后给某个特定用户推送消息时,就可以用此别名来指定。
(3)每个用户只能指定一个别名。所以同一个设备,新设置的别名会覆盖旧的。(2)以后给某个特定用户推送消息时,就可以用此别名来指定。
(4)如果要删除已有的别名,只要将别名设置为空字符串即可。
(5)系统不限定一个别名只能指定一个用户。如果一个别名被指定到了多个用户,当给指定这个别名发消息时,服务器端API会同时给这多个用户发送消息。
(2)限制:alias 命名长度限制为 40 字节。(判断长度需采用 UTF-8 编码)
三、别名使用的样例说明
下面是一个给指定用户发送消息的样例。
1,iOS客户端界面
客户端在启动后,我们可以在输入框中填写 alias 别名,点击“注册别名”按钮后,便调用 API 将该设备与这个别名关联起来。
注意:这么做只是为了演示而已,实际项目中应该是 App 在后台就自动去注册别名(比如在登录成功后),而不是由用户去干预。
2,服务端界面
注意:这么做只是为了演示而已,实际项目中应该是 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 @UIApplicationMain class 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 JPushClient 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> |