# livechat
**Repository Path**: kaierwen/livechat
## Basic Information
- **Project Name**: livechat
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-02-05
- **Last Updated**: 2025-02-05
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# 💬 livechat
[](https://codecov.io/gh/Mastersam07/livechat)
[](https://github.com/Mastersam07/livechat/blob/master/LICENSE)
[](https://pub.dartlang.org/packages/livechatt)
[](https://github.com/Mastersam07/livechat/pulls)
A livechat package for embedding mobile chat window in your mobile application.
## 🎖 Installing
```yaml
dependencies:
livechatt: ^1.5.1
```
### ⚡️ Import
```dart
import 'package:livechatt/livechatt.dart';
```
## 🎮 How To Use
> Get the [Crendentials](https://www.livechat.com) for your LiveChat
### Android
>- Edit AndroidManifest.xml as shown below
#### Internet and Storage Access
```xml
```
#### ChatWindow
```xml
```
### iOS - Manifest
>- Set minimum deployment target of iOS to 11.0
>- Edit info.plist as shown below
#### Sending Files From Device Library
```plist
NSPhotoLibraryUsageDescription
This app requires access to the photo library.
NSMicrophoneUsageDescription
This app require access to the microphone.
NSCameraUsageDescription
This app requires access to the camera.
```
#### Having issues running on ios?
Add the below to your podfile
```podfile
post_install do |installer|
installer.pods_project.targets.each do |target|
flutter_additional_ios_build_settings(target)
target.build_configurations.each do |config|
config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '11.0'
end
end
end
```
### Dart Usage
- Regular usage
```dart
onPressed: (){
Livechat.beginChat(LICENSE_NO);
},
```
- Cases where there are custom parameters
```dart
var cmap = {
'org': 'organizationTextController.text',
'position': 'positionTextController.text'
};
onPressed: (){
Livechat.beginChat(
LICENSE_NO,
groupId: GROUP_ID,
visitorName: VISITOR_NAME,
visitorEmail: VISITOR_EMAIL,
customParams: cmap,
);
},
```
For more info, please, refer to the `main.dart` in the example.
### Embedded Chat Views
The package now supports embedded views for custom positioning within your app’s layout:
```dart
var cmap = {
'org': 'organizationTextController.text',
'position': 'positionTextController.text'
};
Livechat.embeddedChat(
licenseNo: 'your_license',
groupId: 'group_id',
visitorEmail: 'visitor_email',
visitorName: 'visitor_name',
customParams: cmap,
)
```
For more info, please refer to `EmbeddedChatWidget` in `main.dart` in the example.
### Events Streaming
> Android only
The plugin streams various events such as new messages, visibility changes, and errors from the chat window. You can listen to events like this:
```dart
Livechat.chatEvents.listen((event) {
print(event);
});
```
For specific events, you can stream:
##### New Messages:
```dart
Livechat.newMessages.listen((message) {
print(message);
});
```
##### Visibility Changes:
```dart
Livechat.visibilityChanges.listen((isVisible) {
print("Chat Window is visible: $isVisible");
});
```
##### Errors:
```dart
Livechat.errors.listen((error) {
print("Error: ${error['errorDescription']}");
});
```
##### Uri handling:
```dart
Livechat.uriHandlers.listen((message) {
print(message);
});
```
##### File picker activity:
```dart
Livechat.filePickerActivity.listen((message) {
print(message);
});
```
##### Window initialization:
```dart
Livechat.windowInitialized.listen((message) {
print(message);
});
```
For more info, please refer to `EmbeddedChatWidget` in `main.dart` in the example.
### Views
## 🐛 Bugs/Requests
If you encounter any problems feel free to open an issue. If you feel the library is
missing a feature, please raise a ticket on Github and I'll look into it.
Pull request are also welcome.
### ❗️ Note
This project is a starting point for a Flutter
[plug-in package](https://flutter.dev/developing-packages/),
a specialized package that includes platform-specific implementation code for
Android and/or iOS.
For help getting started with Flutter, view our
[online documentation](https://flutter.dev/docs), which offers tutorials,
samples, guidance on mobile development, and a full API reference.
## 🤓 Developer(s)
[
](https://mastersam.tech)
#### **Abada Samuel Oghenero**
## ⭐️ License
#### MIT LICENSE