当前位置：网站首页>Summer Challenge harmonyos - realize message notification function

Summer Challenge harmonyos - realize message notification function

2022-07-05 19:52:00 【51CTO】

author ： Zhang Mingwei

This article is participating in the starlight project 3.0– Summer Challenge

Preface

Notification is the message push of mobile software , Generally, you need to set the permission of notification to allow notification to view the notification in the status bar . There are mainly the following usage scenarios ：

app Notification within ： Such as the reminder of wechat new news , As well as some APP Advertising push ,APP Version update ;
System notification , If the power is too low , Text messages, reminders, etc ;
Show ongoing events , Like music playing , Downloading and so on are all notices .

Effect display

# Summer Challenge # HarmonyOS - Realize the message notification function _ Notification message

Implementation steps

1. Define the event that triggers the notification

1.1 First, we need to define UI

（ In general , Unwanted UI, This example defines UI）

	 <!-- Text notification button -->
        <button class="button_notification" onclick="clickStartInputNotification">
            {{$t('strings.startInputNotifiction')}}
        </button>
     <!-- Picture notification button -->
        <button class="button_notification" onclick="clickStartButtonNotifiction">
            {{$t('strings.startButtonNotifiction')}}
        </button>
     <!-- Notice of cancellation -->
        <button class="button_notification" onclick="clickCancelNotification">
            {{$t('strings.cancelNotifiction')}}
        </button>

     1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.

1.2 Realization JS FA call PA The logic of , And implement click events

import prompt from '@system.prompt';
export default {
	// Text notification 
    clickStartInputNotification:function(){
        this.showToast("clickStartInputNotification");
        this.notification(0x1001);
    },
    // Picture notification 
    clickStartButtonNotifiction:function(){
        this.showToast("clickStartButtonNotifiction");
        this.notification(0x1002);
    },
    // Notice of cancellation 
    clickCancelNotification:function(){
        this.showToast("clickCancelNotification");
        this.notification(0x1003);
    },
    // initialization action
    initAction: function (code) {
        var actionData = {};
        actionData.notify = "this actionData form JS ";
        var action = {};
        action.bundleName = "com.chinasoft.example";
        action.abilityName = "NotificationAbility";
        action.messageCode = code;
        action.data = actionData;
        action.abilityType = 1;
        action.syncOption = 0;
        return action;
    },
    // call PA
    notification: async function(code) {
        try {
            var action = this.initAction(code);
            var result = await FeatureAbility.callAbility(action);
            console.info(" result = " + result);
            this.showToast(result);
        } catch (pluginError) {
            console.error("startNotification : Plugin Error = " + pluginError);
        }
    },
}

     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.

2. Realize the logic of notification

2.1 Realization onRemoteRequest() Method

Build a new one in the project InternalAbility Inherited from AceInternalAbility, Realization onRemoteRequest() Method

   /* *  When JS Side of the call FeatureAbility.callAbility(OBJECT) Interface, call this method , adopt JS The transmitted instruction executes the corresponding function . * */
    public boolean onRemoteRequest(int code, MessageParcel data, MessageParcel reply, MessageOption option) {
        String result = data.readString();
        switch (code) {
            case 0x1001:
                startTextNotification(reply);// Text type notification 
                break;
            case 0x1002:
                startPictureNotification(reply);// Picture type notification 
                break;
            case 0x1003:
                cancelNotification(reply);// Notice of cancellation 
                break;
            default:
                reply.writeString(" The service is not defined ");// If there is no corresponding command, reply 
                return false;
        }
        return true;
    }

     1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.

2.2 stay MainAbility Register and cancel registration

  @Override
    public void onStart(Intent intent) {
        super.onStart(intent);
        NotificationAbility.register(this);// When MainAbility Register when creating 
    }
    @Override
    public void onStop() {
        super.onStop();
        NotificationAbility.deRegister();// When Ability Write off when destroying 
    }

     1.
2.
3.
4.
5.
6.
7.
8.
9.
10.

2.3 Inform the development steps

Notice that the underlying class contains NotificationSlot、NotificationRequest and NotificationHelper.

NotificationSlot The prompt tone can be adjusted 、 Vibration 、 Set the importance level . An application can create one or more NotificationSlot, At the time of the announcement , By binding different NotificationSlot, For different purposes .NotificationRequest Used to set specific notification objects , This includes setting the properties of the notification , Such as ： The distribution time of the notice 、 Small icons 、 Large icon 、 Automatically delete and other parameters , And setting specific notification types , Like plain text 、 Long text, etc .NotificationHelper Encapsulates the release 、 to update 、 Static methods such as delete notification . Here we mainly introduce text message notification and picture message notification .

2.3.1 Define the notification type and set the basic attribute content

Set the header text of the text notification , Notification heading , Contents of the notice .

         //1. Set the type of notification and the title of the notification , Text and other attributes 
        NotificationRequest.NotificationNormalContent normalContent
                = new NotificationRequest.NotificationNormalContent();
        normalContent.setTitle(" Text message notification ");// Set the title of the notification 
        normalContent.setAdditionalText(" Header text ");// Set the header text of the notification 
        normalContent.setText(" This is a text message notification ");// Set the body content of the notification 
 

     1.
2.
3.
4.
5.
6.
7.

Set the header text of the picture notification , Notification heading , Brief introduction of the notice , Notice picture .

  pictureContent.setTitle("notifiction");
  PixelMap pixelMap = getPixMap();
  pictureContent.setBigPicture(pixelMap);// Set notification display picture 
  pictureContent.setAdditionalText(" This is a picture notification ");// Set the header text of the notification 
  pictureContent.setBriefText(" Introduction to the notice ");// Brief introduction of setting notification 

     1.
2.
3.
4.
5.

2.3.2 Define the response button for the notification

If the response button is text, you need to set builder The first parameter of is null, If the response button is an image, you need to set builder The first parameter of is PixelMap object

			//2. Set the response button for the notification 
        IntentAgent intentAgent = setIntentAgent();
        NotificationActionButton actionButton = new NotificationActionButton.Builder(null,
                " reply ", intentAgent)// Set the text content of the reply button and set the reply action
                .addNotificationUserInput(
                        new NotificationUserInput.Builder("QUICK_NOTIFICATION_REPLY")
                                .setTag(" Input text ").build())// Set the reply message tag
                .setSemanticActionButton(NotificationConstant.SemanticActionButton.ARCHIVE_ACTION_BUTTON)
                .setAutoCreatedReplies(false)
                .build();

     1.
2.
3.
4.
5.
6.
7.
8.
9.
10.

2.3.3 NotificationRequest Set up

adopt NotificationRequest Object encapsulates the message , Set notification content ,id And the reply button .

 		NotificationRequest.NotificationContent notificationContent = new NotificationRequest.NotificationContent(
                normalContent);// take normalContent As a parameter to NotificationRequest object 
        NotificationRequest notificationRequest = new NotificationRequest(100);// Set up notifications id
        notificationRequest.setContent(notificationContent);//notificationRequest Object to set the notification content 
        notificationRequest.addActionButton(actionButton);// Add the reply action button to notificationRequest

     1.
2.
3.
4.
5.

2.3.4 Issue notice

（ After the notification is released, the status bar of the mobile phone will display the notification information ）

By calling NotificationHelper Of publishNotification(NotificationRequest notificationRequest)

2.3.5 Notice of cancellation

（ After canceling the notification, the notification will disappear from the mobile phone status bar ）

By calling NotificationHelper Of cancelNotification(notification id) Method to implement , adopt notificationid To identify the notice .

2.3.6 Other features

If you want the prompt tone of the notice , Vibration , Set the importance level , Need to use NotificationSlot object , You need to set it before publishing .

Its main interfaces are shown in the table below .

The interface name	describe
NotificationSlot(String id, String name, int level)	structure NotificationSlot.
setLevel(int level)	Set up NotificationSlot The level of .
setName(String name)	Set up NotificationSlot The name of .
setDescription(String description)	Set up NotificationSlot Description information of .
enableBypassDnd(boolean bypassDnd)	Set whether to bypass the undisturbed mode of the system .
setEnableVibration(boolean vibration)	Set whether to enable vibration when receiving notification .
setEnableLight(boolean isLightEnabled)	Set whether to turn on the breathing light when receiving the notification , The premise is that the current hardware supports breathing lamps .
setLedLightColor(int color)	Set the color of the breathing light when receiving the notification .

Be careful ： This object has real effect only on real machine .

summary

The above is the whole process of developing a message notification , The application of message notification is a APP The essential part , yes APP A channel to interact with users . Because I just started to contact Hongmeng , There are many inappropriate expressions , Please correct more ！

For more original content, please pay attention to ： China soft International HarmonyOS Technical team

Beginner to master 、 Skills to cases , Systematic sharing HarmonyOS Development technology , Welcome to contribute and subscribe , Let's move forward hand in hand to build Hongmeng ecology .

Want to know more about open source , Please visit ：

51CTO Open source basic software community

https://ost.51cto.com/#bkwz

原网站

版权声明
本文为[51CTO]所创，转载请带上原文链接，感谢
https://yzsam.com/2022/186/202207051833076628.html