Skip to content

Latest commit

 

History

History
519 lines (432 loc) · 19.4 KB

README.md

File metadata and controls

519 lines (432 loc) · 19.4 KB
Raw

ChatView for Android

Repo no longer being maintained


This is an Android library which can be used to add chat functionality to your android application with just a few lines of code.
This library is still in beta but will be improved over time.

Version

Installation

Add this to your root build.gradle at the end of repositories:

allprojects {
	repositories {
		...
		maven { url 'https://jitpack.io' }
	}
}

Then add dependency

dependencies {
	compile 'com.github.shrikanth7698:ChatView:v0.1.2'
}

Usage

Drop the ChatView in your XML layout as is shown below:

    <com.shrikanthravi.chatview.widget.ChatView
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        app:showSenderLayout="false" 
        app:leftBubbleLayoutColor="#ff7b7b"
        app:rightBubbleLayoutColor="@color/colorAccent2"
        app:leftBubbleTextColor="@android:color/white"
        app:rightBubbleTextColor="@android:color/black"
        android:layout_above="@+id/sendLL"
        app:showSenderName="true"
        android:id="@+id/chatView">

    </com.shrikanthravi.chatview.widget.ChatView>

don't forget to add this attribute to your root layout.

xmlns:app="http://schemas.android.com/apk/res-auto"

And then in your Activity or Fragment

ChatView chatView = (ChatView) findViewById(R.id.chatview);

Sample code

//sample code to add message to right
Message message = new Message();
                    message.setBody(messageET.getText().toString().trim()); //message body
                    message.setType(Message.RightSimpleMessage); //message type
                    message.setTime(getTime()); //message time (String)
                    message.setUserName("Groot"); //sender name
		    //sender icon
                    message.setUserIcon(Uri.parse("android.resource://com.shrikanthravi.chatviewlibrary/drawable/groot")); 
                    chatView.addMessage(message);
		    
//sample code to add message to left
Message message1 = new Message();
                    message1.setBody(messageET.getText().toString().trim());
                    message1.setType(Message.LeftSimpleMessage);
                    message1.setTime(getTime());
                    message1.setUserName("Hodor");
                    message1.setUserIcon(Uri.parse("android.resource://com.shrikanthravi.chatviewlibrary/drawable/hodor"));
		    chatView.addMessage(message);

//to clear messages
chatview.clearMessages();

//to remove message
chatview.remove(position) //or  chatview.remove(message)

Message types

//Message.LeftSimpleMessage
	Message message = new Message();
	message.setType(Message.LeftSimpleMessage);
	message.setBody(body); //string
	message.setTime(getTime());
	chatView.addMessage(message);
	
//Message.RightSimpleMessage
	Message message = new Message();
	message.setType(Message.RightSimpleMessage);
	message.setBody(body); //string
	message.setTime(getTime());
	chatView.addMessage(message);
	
//Message.LeftSingleImage  (when clicked it will go to fullscreen mode)
	Message message = new Message();
	List<Uri> mSelected  = new ArrayList<>();
	mselected.add(Uri.parse("Your image"))
	message.setTime(getTime());
	message.setType(Message.LeftSingleImage);
	message.setImageList(mSelected);
	chatView.addMessage(message);	
	
// Message.RightSingleImage (when clicked it will go to fullscreen mode)
	Message message = new Message();
	List<Uri> mSelected  = new ArrayList<>();
	mselected.add(Uri.parse("Your image"));
	message.setTime(getTime());
	message.setType(Message.RightSingleImage);
	message.setImageList(mSelected);	
	chatView.addMessage(message);
	
// Message.LeftMultipleImages (can hold upto 10 images in a single row as a collage view)
	Message message = new Message();
	List<Uri> mSelected  = new ArrayList<>();
	mselected.add(Uri.parse("Your image"));
	mselected.add(Uri.parse("Your image"));
	mselected.add(Uri.parse("Your image"));	
	message.setTime(getTime());
	message.setType(Message.LeftMultipleImages);
	message.setImageList(mSelected);
	chatView.addMessage(message);
	
// Message.RightMultipleImages (can hold upto 10 images in a single row as a collage view)
	Message message = new Message();
	List<Uri> mSelected  = new ArrayList<>();
	mselected.add(Uri.parse("Your image"));
	mselected.add(Uri.parse("Your image"));
	mselected.add(Uri.parse("Your image"));	
	message.setTime(getTime());
	message.setType(Message.RightMultipleImages);
	message.setImageList(mSelected);
	chatView.addMessage(message);
	
// Message.LeftVideo (when clicked it will go to fullscreen mode)	
	Message message = new Message();
	message.setType(Message.LeftVideo);
        message.setTime(getTime());
	message.setUserName("Hodor");
	message.setVideoUri(Uri.parse(getPath(data.getData())));
	message.setUserIcon(Uri.parse("android.resource://com.shrikanthravi.chatviewlibrary/drawable/hodor"));
	hatView.addMessage(message);

// Message.RightVideo (when clicked it will go to fullscreen mode)
	Message message = new Message();
	message.setType(Message.RightVideo);
	message.setTime(getTime());
	message.setUserName("Groot");
	message.setVideoUri(Uri.parse(getPath(data.getData())));
	message.setUserIcon(Uri.parse("android.resource://com.shrikanthravi.chatviewlibrary/drawable/groot"));
	chatView.addMessage(message);

Sender Layout

You should have a accent color in your colors.xml otherwise view will crash.

You can hide or show sender layout

app:showSenderLayout="true or false"

This is still in beta

Sender Layout has 4 buttons for now.

  • Send Button

  • Camera Button

  • Gallery Button

  • Video Button

and a Text box

You can change the color of buttons by changing the accent color you use in your app.

Note: You should use your own logic of picking images,videos and capturing images.

In this sample I used an external library to pick images from gallery.

	//Send button click listerer
        chatView.setOnClickSendButtonListener(new ChatView.OnClickSendButtonListener() {
            @Override
            public void onSendButtonClick(String body) {
                if(switchbool) {
                    Message message = new Message();
                    message.setBody(body);
                    message.setType(Message.RightSimpleMessage);
                    message.setTime(getTime());
                    message.setUserName("Groot");
                    message.setUserIcon(Uri.parse("android.resource://com.shrikanthravi.chatviewlibrary/drawable/groot"));
                    chatView.addMessage(message);

                    switchbool=false;
                }
                else{
                    Message message1 = new Message();
                    message1.setBody(body);
                    message1.setType(Message.LeftSimpleMessage);
                    message1.setTime(getTime());
                    message1.setUserName("Hodor");
                    message1.setUserIcon(Uri.parse("android.resource://com.shrikanthravi.chatviewlibrary/drawable/hodor"));
                    chatView.addMessage(message1);

                    switchbool=true;
                }
            }
        });

        //Gallery button click listener
        chatView.setOnClickGalleryButtonListener(new ChatView.OnClickGalleryButtonListener() {
            @Override
            public void onGalleryButtonClick() {
                Matisse.from(ChatViewTestActivity.this)
                        .choose(MimeType.allOf())
                        .countable(true)
                        .maxSelectable(9)
                        .restrictOrientation(ActivityInfo.SCREEN_ORIENTATION_UNSPECIFIED)
                        .thumbnailScale(0.85f)
                        .imageEngine(new PicassoEngine())
                        .forResult(imagePickerRequestCode);
            }
        });

        //Video button click listener
        chatView.setOnClickVideoButtonListener(new ChatView.OnClickVideoButtonListener() {
            @Override
            public void onVideoButtonClick() {
                Intent i = new Intent(Intent.ACTION_PICK, android.provider.MediaStore.Video.Media.EXTERNAL_CONTENT_URI);
                i.setType("video/*");
                startActivityForResult(i, SELECT_VIDEO);
            }
        });

        //Camera button click listener
        chatView.setOnClickCameraButtonListener(new ChatView.OnClickCameraButtonListener() {
            @Override
            public void onCameraButtonClicked() {
                Intent cameraIntent = new Intent(android.provider.MediaStore.ACTION_IMAGE_CAPTURE);
                File file = new File(Environment.getExternalStorageDirectory(), "MyPhoto.jpg");
                file.delete();
                File file1 = new File(Environment.getExternalStorageDirectory(), "MyPhoto.jpg");

                Uri uri = FileProvider.getUriForFile(ChatViewTestActivity.this, getApplicationContext().getPackageName() + ".provider", file1);
                cameraIntent.putExtra(android.provider.MediaStore.EXTRA_OUTPUT, uri);
                startActivityForResult(cameraIntent, CAMERA_REQUEST);
            }
        });
	
	
	@Override
    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
        super.onActivityResult(requestCode, resultCode, data);

        //Image Selection result
        if (requestCode == imagePickerRequestCode && resultCode == RESULT_OK) {
            mSelected = Matisse.obtainResult(data);

                if(switchbool) {
                    if (mSelected.size() == 1) {
                        Message message = new Message();
                        message.setBody(messageET.getText().toString().trim());
                        message.setType(Message.RightSingleImage);
                        message.setTime(getTime());
                        message.setUserName("Groot");
                        message.setImageList(mSelected);
                        message.setUserIcon(Uri.parse("android.resource://com.shrikanthravi.chatviewlibrary/drawable/groot"));
                        chatView.addMessage(message);
                        switchbool=false;
                    } else {

                        Message message = new Message();
                        message.setBody(messageET.getText().toString().trim());
                        message.setType(Message.RightMultipleImages);
                        message.setTime(getTime());
                        message.setUserName("Groot");
                        message.setImageList(mSelected);
                        message.setUserIcon(Uri.parse("android.resource://com.shrikanthravi.chatviewlibrary/drawable/groot"));
                        chatView.addMessage(message);
                        switchbool=false;
                    }
                }
                else{

                    if (mSelected.size() == 1) {
                        Message message = new Message();
                        message.setBody(messageET.getText().toString().trim());
                        message.setType(Message.LeftSingleImage);
                        message.setTime(getTime());
                        message.setUserName("Hodor");
                        message.setImageList(mSelected);
                        message.setUserIcon(Uri.parse("android.resource://com.shrikanthravi.chatviewlibrary/drawable/hodor"));
                        chatView.addMessage(message);
                        switchbool=true;
                    } else {

                        Message message = new Message();
                        message.setBody(messageET.getText().toString().trim());
                        message.setType(Message.LeftMultipleImages);
                        message.setTime(getTime());
                        message.setUserName("Hodor");
                        message.setImageList(mSelected);
                        message.setUserIcon(Uri.parse("android.resource://com.shrikanthravi.chatviewlibrary/drawable/hodor"));
                        chatView.addMessage(message);
                        switchbool=true;
                    }

                }
            }
            else {

            //Video Selection result
            if (requestCode == SELECT_VIDEO && resultCode == RESULT_OK) {


                if (switchbool) {
                    Message message = new Message();
                    message.setType(Message.RightVideo);
                    message.setTime(getTime());
                    message.setUserName("Groot");
                    message.setVideoUri(Uri.parse(getPath(data.getData())));
                    message.setUserIcon(Uri.parse("android.resource://com.shrikanthravi.chatviewlibrary/drawable/groot"));
                    chatView.addMessage(message);
                    switchbool = false;
                } else {
                    Message message = new Message();

                    message.setType(Message.LeftVideo);
                    message.setTime(getTime());
                    message.setUserName("Hodor");
                    message.setVideoUri(Uri.parse(getPath(data.getData())));
                    message.setUserIcon(Uri.parse("android.resource://com.shrikanthravi.chatviewlibrary/drawable/hodor"));
                    chatView.addMessage(message);
                    switchbool = true;
                }
            }
            else{

                //Image Capture result
                if (requestCode == CAMERA_REQUEST && resultCode == RESULT_OK) {


                    if (switchbool) {
                        Message message = new Message();
                        message.setType(Message.RightSingleImage);
                        message.setTime(getTime());
                        message.setUserName("Groot");
                        mSelected.clear();
                        File file = new File(Environment.getExternalStorageDirectory(), "MyPhoto.jpg");
                        //Uri of camera image
                        Uri uri = FileProvider.getUriForFile(this, getApplicationContext().getPackageName() + ".provider", file);
                        mSelected.add(uri);
                        message.setImageList(mSelected);
                        message.setUserIcon(Uri.parse("android.resource://com.shrikanthravi.chatviewlibrary/drawable/groot"));
                        chatView.addMessage(message);
                        switchbool = false;
                    } else {
                        Message message = new Message();

                        message.setType(Message.LeftSingleImage);
                        message.setTime(getTime());
                        message.setUserName("Hodor");
                        mSelected.clear();
                        File file = new File(Environment.getExternalStorageDirectory(), "MyPhoto.jpg");
                        //Uri of camera image
                        Uri uri = FileProvider.getUriForFile(this, getApplicationContext().getPackageName() + ".provider", file);
                        mSelected.add(uri);
                        message.setImageList(mSelected);
                        message.setUserIcon(Uri.parse("android.resource://com.shrikanthravi.chatviewlibrary/drawable/hodor"));
                        chatView.addMessage(message);
                        switchbool = true;
                    }
                }

            }


            }


        }

Customization

Note: You can customize the chatview in both xml and java way.

//xml 

<com.shrikanthravi.chatview.widget.ChatView
        android:layout_width="match_parent"
        android:layout_height="match_parent"
	app:showLeftBubbleIcon="true or false" //  (4)
	app:showRightBubbleIcon="true or false" //  (2)
        app:showSenderLayout="false" // still in beta (set the value to false)
        app:leftBubbleLayoutColor="#ff7b7b"  //   (5)
        app:rightBubbleLayoutColor="@color/colorAccent2" //   (3)
        app:leftBubbleTextColor="@android:color/white" // (5)
        app:rightBubbleTextColor="@android:color/black" //  (3)
        android:layout_above="@+id/sendLL"
	app:textSize="text size"
	app:chatViewBackground="your color"  //   (10)
	app:timeTextColor="your color" 	//  (11)
        app:showSenderName="true" //  (1)
        android:id="@+id/chatView">
	
//java


//Message.LeftSingleImage      (7)
	List<Uri> mSelected  = new ArrayList<>();
	mselected.add(Uri.parse("Your image"))
	message.setType(Message.LeftSingleImage);
	message.setImageList(mSelected);
	
//Message.RightSingleImage    (6)
	List<Uri> mSelected  = new ArrayList<>();
	mselected.add(Uri.parse("Your image"));
	message.setType(Message.RightSingleImage);
	message.setImageList(mSelected);	
	
//Message.LeftMultipleImages (can hold upto 10 images in a single row as a collage view)   (9)
	List<Uri> mSelected  = new ArrayList<>();
	mselected.add(Uri.parse("Your image"));
	mselected.add(Uri.parse("Your image"));
	mselected.add(Uri.parse("Your image"));	
	message.setType(Message.LeftMultipleImages);
	message.setImageList(mSelected);	
	
//Message.RightMultipleImages (can hold upto 10 images in a single row as a collage view)   (8)
	List<Uri> mSelected  = new ArrayList<>();
	mselected.add(Uri.parse("Your image"));
	mselected.add(Uri.parse("Your image"));
	mselected.add(Uri.parse("Your image"));	
	message.setType(Message.RightMultipleImages);
	message.setImageList(mSelected);

Features

  • Supports Group mode (Like whatsapp group).
  • Supports multiple images in a single row.
  • Video preview
  • Easily customizable.

Check the sample app https://github.com/shrikanth7698/ChatView/tree/master/app

Upcoming features

  • Video Support (Completed)
  • Location Support
  • Contact support

Contributions are welcome

License

MIT License

Copyright (c) 2018 Shrikanth Ravi

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.