20 lines of code fast APP plus chat function

Source: Internet
Author: User

Many apps now need to integrate IM capabilities, and today we'll share the steps to integrate IM basic functionality. This article takes Jmessage as an example.
Aurora im (jmessage) = Aurora push (Jpush) + IM, this article discusses only the IM part of it, providing a concise example of how quickly you integrate IM functionality.

Let's take a look at the correspondence between the basic functions of IM and the content of this article:

Line 0: Getting Ready for work
    • Download SDK
    • Integration SDK
Line 1: Introduction of header File
#import <JMessage/JMessage.h>

Jmessage Core header file. This is the only header file that needs to be imported into your project, and it references a header file that needs to be used internally.

Line 2: Turn on event monitoring
[JMessage addDelegate:self withConversation:nil];
    • For monitoring various global events
    • Suggested before Line 3
    • Parameters:
      • Delegate: Fill in objects need to implement <JMessageDelegate>
      • Conversation:nil monitoring of all notifications, non-nil monitoring of the specified session
Line 3: Launch SDK
[JMessage setupJMessage:launchOptions                 appKey:@"your appkey"                channel:@"channel name" apsForProduction:NO category:nil];
    • Suggestions are written application:didFinishLaunchingWithOptions: in
    • Parameters:
      • Launchoptions: parameter of the start function launchingoption
      • AppKey: Get Way Line 0-integrated SDK
      • Channel: The name of the application
      • Isproduction: Whether it is a production mode
      • CATEGORY:IOS8 new Notification Shortcut button parameters
Line 4: Register a new user
[JMSGUser registerWithUsername:@"username"                       password:@"password"             completionHandler:^(id resultObject, NSError *error) {}];

Parameters:

    • Username: User Name
    • Password: password
    • Successful call when Handler:error is nil (bottom)
Line 5: Login
[JMSGUser loginWithUsername:@"username"                    password:@"password"           completionHandler:^(id resultObject, NSError *error) {}];
Line 6: Create a single chat session
[JMSGConversation createSingleConversationWithUsername:@"username"                                      completionHandler:^(id resultObject, NSError *error) {}];
    • A session is the core of the entire IM, and all message behaviors are based on the "session"
    • The session does not exist and will return a Xinhui session, which will return existing sessions
    • Parameters:
      • Handler: Resultobject is jmsgconversation Session object when normal return
      • ((jmsgconversation*) resultobject). Target: The opponent of the session:
        • User Object Jmsguser
        • Group Object Jmsggroup
    • Related APIs:
      • Create a single-chat cross-app session
      • Create a group chat session
Line 7: Send text message
[(JMSGConversation*)resultObject sendTextMessage:@"text"];
    • Transform line 6-handler resultObject and send text messages
    • Related APIs:
      • Send picture message
      • Send Voice message
      • Send a file message
      • Send geo-location messages
Line 8~12: Receiving text messages
- (void)onReceiveMessage:(JMSGMessage *)message error:(NSError *)error{    if (message.content == kJMSGContentTypeText) { NSString *text = ((JMSGTextContent *)message.content).text; }}
    • Added the <JMessageDelegate> class to line 2 to listen to this method
    • This method is called when the APP receives messages (text, images, etc.)
    • by message.contentType Judging the message type
    • Transform message.content to text content and get text text to show UI
    • Related APIs:
      • Picture content
      • Sound content
      • File contents
Line 13: Get historical News
NSArray *messages = [(JMSGConversation*)resultObject messageArrayFromNewestWithOffset:nil limit:nil];
    • Use the transformation in line 6 to resultObject get
    • Single chat group chat can be
    • Parameters:
      • Back to nsarray<jmsgmessage* >
      • Offset: The starting point. Nil starts with the latest article, and N is traced to history from the latest article n
      • Limit: quantity. Nil table All
Line 14~15:0 Number of unread messages in a single chat
JMSGConversation *conversation = [JMSGConversation singleConversationWithUsername:username];[conversation clearUnreadCount];
    • Related APIs:
      • Qing 0 Group Chat
Line 16: Get a list of sessions
[JMSGConversation allConversations:^(id resultObject, NSError *error) {}];
    • Bulk Get all Sessions list
    • Judging by session type is a single chat or a group chat
    • Parameters:
      • Resultobject:nsarray<jmsgconversation*>
Line 17: Delete a single chat session
BOOL success = [JMSGConversation deleteSingleConversationWithUsername:username];
    • Related APIs:
      • Delete a single chat cross app session
      • Delete a group chat session
Line 18: Get user details in bulk
[JMSGUser userInfoArrayWithUsernameArray:nameArr completionHandler:^(id resultObject, NSError *error) {}];
    • Parameters:
      • Namearray:nsarray<nsstring*>
      • Resultobject:nsarray<jmsguser*>
    • Related APIs:
      • Get the details of this user
      • Modify this user details
      • Modify this user password
Line 19: Create groups and related actions
[JMSGGroup createGroupWithName:name desc:desc memberArray:members completionHandler:^(id resultObject, NSError *error) {}];
    • Parameters:
      • Name: Group name
      • Desc: Group Description
      • Memberarray: Member List,nsarray<nsstring*>
      • Resultobject: Group Object Jmsggroup
    • Related APIs:
      • Get a list of my groups
      • Get a list of group members
      • Add Member
      • Delete Member
      • Retreat Group
      • Get group Details
      • Modify group Details
Line 20: Sign Out
[JMSGUser logout:^(id resultObject, NSError *error) {}];
At this point an IM all the basic operation is over, is it very simple?

Pikacode-Aurora (Jpush for Aurora team account)

Original: 20 lines of code fast APP plus chat function

News column: Aurora Daily

20 lines of code fast APP plus chat function

Related Article

Contact Us

The content source of this page is from Internet, which doesn't represent Alibaba Cloud's opinion; products and services mentioned on that page don't have any relationship with Alibaba Cloud. If the content of the page makes you feel confusing, please write us an email, we will handle the problem within 5 days after receiving your email.

If you find any instances of plagiarism from the community, please send an email to: info-contact@alibabacloud.com and provide relevant evidence. A staff member will contact you within 5 working days.

A Free Trial That Lets You Build Big!

Start building with 50+ products and up to 12 months usage for Elastic Compute Service

  • Sales Support

    1 on 1 presale consultation

  • After-Sales Support

    24/7 Technical Support 6 Free Tickets per Quarter Faster Response

  • Alibaba Cloud offers highly flexible support services tailored to meet your exact needs.