Call Participants

Overview

CometChatCallParticipants is a Component that shows a separate view that displays comprehensive information about Call. This will enable users to easily access details such as the call participants, call details for a more informed communication experience.

iOS

Android

The CallParticipants is comprised of the following components:

Components	Description
CometChatList	a reusable container component having title, search box, customisable background and a List View
CometChatListItem	a component that renders data obtained from a Group object on a Tile having a title, subtitle, leading and trailing view
cometchat-date	This Component used to show the date and time. You can also customize the appearance of this widget by modifying its logic.
cometchat-button	This component represents a button with optional icon and text.

Usage

Integration

App.tsx

import { CometChat, CometChatCalls } from "@cometchat/chat-sdk-react-native";
import { CometChatParticipants } from "@cometchat/chat-uikit-react-native";
import {
  CallLog,
  CallLogRequestBuilder,
} from "@cometchat/calls-sdk-react-native";

function App(): React.JSX.Element {
  const [loggedInUser, setLoggedInUser] = useState<CometChat.User>();
  const [callLog, setCallLog] = useState<CallLog>();
  useEffect(() => {
    //code
    CometChatUIKit.login({ uid: "uid" })
      .then(async (user: CometChat.User) => {
        setLoggedInUser(user);
        const callLogRequest = new CallLogRequestBuilder()
          .setLimit(1)
          .setCallStatus("cancelled")
          .setAuthToken(user!.getAuthToken())
          .build();

        callLogRequest
          .fetchNext()
          .then((callLogs: CallLog[]) => {
            setCallLog(callLogs[0]);
          })
          .catch(() => {
            //handle error
          });
      })
      .catch((error: any) => {
        //handle error
      });
  }, []);

  return (
    <>
      {callLog && (
        <CometChatParticipants
          call={callLog}
          data={callLog!.getParticipants()}
        ></CometChatParticipants>
      )}
    </>
  );
}

Actions

Actions dictate how a component functions. They are divided into two types: Predefined and User-defined. You can override either type, allowing you to tailor the behavior of the component to fit your specific needs.

1. onItemPress

onItemPress is triggered when you click on a ListItem of the of the CallParticipants component. It does not have a default behavior. However, you can override its behavior using the following code snippet.

App.tsx

import { CometChat, CometChatCalls } from "@cometchat/chat-sdk-react-native";
import { CometChatParticipants } from "@cometchat/chat-uikit-react-native";
import {
  CallLog,
  CallLogRequestBuilder,
} from "@cometchat/calls-sdk-react-native";

function App(): React.JSX.Element {
  const [loggedInUser, setLoggedInUser] = useState<CometChat.User>();
  const [callLog, setCallLog] = useState<CallLog>();
  useEffect(() => {
    //code
    CometChatUIKit.login({ uid: "uid" })
      .then(async (user: CometChat.User) => {
        setLoggedInUser(user);
        const callLogRequest = new CallLogRequestBuilder()
          .setLimit(1)
          .setCallStatus("cancelled")
          .setAuthToken(user!.getAuthToken())
          .build();

        callLogRequest
          .fetchNext()
          .then((callLogs: CallLog[]) => {
            setCallLog(callLogs[0]);
          })
          .catch(() => {
            //handle error
          });
      })
      .catch((error: any) => {
        //handle error
      });
  }, []);

  const onItemPressHandler = (item: any) => {
    //code
  };

  return (
    <>
      {callLog && (
        <CometChatParticipants
          call={callLog}
          data={callLog!.getParticipants()}
          onItemPress={onItemPressHandler}
        ></CometChatParticipants>
      )}
    </>
  );
}

2. onBack

The onBack function is built to respond when you press the back button in the AppBar. The back button is only displayed when the prop showBackButton is set to true.

App.tsx

import { CometChat, CometChatCalls } from "@cometchat/chat-sdk-react-native";
import { CometChatParticipants } from "@cometchat/chat-uikit-react-native";
import {
  CallLog,
  CallLogRequestBuilder,
} from "@cometchat/calls-sdk-react-native";

function App(): React.JSX.Element {
  const [loggedInUser, setLoggedInUser] = useState<CometChat.User>();
  const [callLog, setCallLog] = useState<CallLog>();
  useEffect(() => {
    //code
    CometChatUIKit.login({ uid: "uid" })
      .then(async (user: CometChat.User) => {
        setLoggedInUser(user);
        const callLogRequest = new CallLogRequestBuilder()
          .setLimit(1)
          .setCallStatus("cancelled")
          .setAuthToken(user!.getAuthToken())
          .build();

        callLogRequest
          .fetchNext()
          .then((callLogs: CallLog[]) => {
            setCallLog(callLogs[0]);
          })
          .catch(() => {
            //handle error
          });
      })
      .catch((error: any) => {
        //handle error
      });
  }, []);

  const onBackHandler = () => {
    //code
  };

  return (
    <>
      {callLog && (
        <CometChatParticipants
          call={callLog}
          data={callLog!.getParticipants()}
          onBack={onBackHandler}
          showBackButton={true}
        ></CometChatParticipants>
      )}
    </>
  );
}

---

Filters

Filters allow you to customize the data displayed in a list within a Component. You can filter the list based on your specific criteria, allowing for a more customized. Filters can be applied using RequestBuilders of ChatSDK.

The CallParticipants component does not have any exposed filters.

---

Events

Events are emitted by a Component. By using event you can extend existing functionality. Being global events, they can be applied in Multiple Locations and are capable of being Added or Removed.

The CallParticipants does not produce any events.

---

Customization

To fit your app's design requirements, you have the ability to customize the appearance of the CallParticipants component. We provide exposed methods that allow you to modify the experience and behavior according to your specific needs.

Style

Using Style you can customize the look and feel of the component in your app, These parameters typically control elements such as the color, size, shape, and fonts used within the component.

1. CallLogParticipants Style

To customize the appearance, you can assign a CallLogParticipantsStyle object to the CallParticipants component.

iOS

Android

In this example, we are employing the CallLogParticipantsStyle.

App.tsx

import { CometChat, CometChatCalls } from "@cometchat/chat-sdk-react-native";
import {
  CometChatParticipants,
  CallParticipantsStyleInterface,
} from "@cometchat/chat-uikit-react-native";
import {
  CallLog,
  CallLogRequestBuilder,
} from "@cometchat/calls-sdk-react-native";

function App(): React.JSX.Element {
  const [loggedInUser, setLoggedInUser] = useState<CometChat.User>();
  const [callLog, setCallLog] = useState<CallLog>();
  useEffect(() => {
    //code
    CometChatUIKit.login({ uid: "uid" })
      .then(async (user: CometChat.User) => {
        setLoggedInUser(user);
        const callLogRequest = new CallLogRequestBuilder()
          .setLimit(1)
          .setCallStatus("cancelled")
          .setAuthToken(user!.getAuthToken())
          .build();

        callLogRequest
          .fetchNext()
          .then((callLogs: CallLog[]) => {
            setCallLog(callLogs[0]);
          })
          .catch(() => {
            //handle error
          });
      })
      .catch((error: any) => {
        //handle error
      });
  }, []);

  const callLogParticipantsStyle: CallParticipantsStyleInterface = {
    titleColor: "#6851D6",
    backgroundColor: "#d2cafa",
  };

  return (
    <>
      {callLog && (
        <CometChatParticipants
          call={callLog}
          data={callLog!.getParticipants()}
          callLogParticipantsStyle={callLogParticipantsStyle}
          listItemStyle={{ backgroundColor: "#d2cafa" }}
        ></CometChatParticipants>
      )}
    </>
  );
}

---

The following properties are exposed by CallLogParticipantsStyle:

Property	Description	Code
border	Used to set border	border?: BorderStyleInterface,
borderRadius	Used to set border radius	borderRadius?: number;
backgroundColor	Used to set background colour	background?: string;
height	Used to set height	height?: number | string;
width	Used to set width	width?: number | string;
titleFont	Used to set title font	titleFont?: FontStyleInterface,
titleColor	Used to set title color	titleColor?: string;
dateTextFont	Used to set date text font	dateTextFont?: FontStyleInterface;
dateTextColor	Used to set date text color	dateTextColor?: string;
emptyTextColor	Used to set empty state text color	emptyTextColor?: string;
emptyTextFont	Used to set empty state text font	emptyTextFont?: FontStyleInterface;
backIconTint	Used to set back icon tint	backIconTint?: string;
durationTextFont	Used to set call duration text font	durationTextFont?: FontStyleInterface;
durationTextColor	Used to set call duration text color	durationTextColor?: string;

2. ListItem Style

If you want to apply customized styles to the ListItemStyle component within the CallParticipants Component, you can use the following code snippet. For more information, you can refer ListItem Styles.

App.tsx

import { CometChat, CometChatCalls } from "@cometchat/chat-sdk-react-native";
import {
  CometChatParticipants,
  ListItemStyleInterface,
} from "@cometchat/chat-uikit-react-native";
import {
  CallLog,
  CallLogRequestBuilder,
} from "@cometchat/calls-sdk-react-native";

function App(): React.JSX.Element {
  const [loggedInUser, setLoggedInUser] = useState<CometChat.User>();
  const [callLog, setCallLog] = useState<CallLog>();
  useEffect(() => {
    //code
    CometChatUIKit.login({ uid: "uid" })
      .then(async (user: CometChat.User) => {
        setLoggedInUser(user);
        const callLogRequest = new CallLogRequestBuilder()
          .setLimit(1)
          .setCallStatus("cancelled")
          .setAuthToken(user!.getAuthToken())
          .build();

        callLogRequest
          .fetchNext()
          .then((callLogs: CallLog[]) => {
            setCallLog(callLogs[0]);
          })
          .catch(() => {
            //handle error
          });
      })
      .catch((error: any) => {
        //handle error
      });
  }, []);

  const listItemStyle: ListItemStyleInterface = {
    titleColor: "red",
    backgroundColor: "#d2cafa",
  };

  return (
    <>
      {callLog && (
        <CometChatParticipants
          call={callLog}
          data={callLog!.getParticipants()}
          listItemStyle={listItemStyle}
        ></CometChatParticipants>
      )}
    </>
  );
}

3. Avatar Style

If you want to apply customized styles to the Avatar component within the CallParticipants Component, you can use the following code snippet. For more information you can refer Avatar Styles.

App.tsx

import { CometChat, CometChatCalls } from "@cometchat/chat-sdk-react-native";
import {
  CometChatParticipants,
  ListItemStyleInterface,
} from "@cometchat/chat-uikit-react-native";
import {
  CallLog,
  CallLogRequestBuilder,
} from "@cometchat/calls-sdk-react-native";

function App(): React.JSX.Element {
  const [loggedInUser, setLoggedInUser] = useState<CometChat.User>();
  const [callLog, setCallLog] = useState<CallLog>();
  useEffect(() => {
    //code
    CometChatUIKit.login({ uid: "uid" })
      .then(async (user: CometChat.User) => {
        setLoggedInUser(user);
        const callLogRequest = new CallLogRequestBuilder()
          .setLimit(1)
          .setCallStatus("cancelled")
          .setAuthToken(user!.getAuthToken())
          .build();

        callLogRequest
          .fetchNext()
          .then((callLogs: CallLog[]) => {
            setCallLog(callLogs[0]);
          })
          .catch(() => {
            //handle error
          });
      })
      .catch((error: any) => {
        //handle error
      });
  }, []);

  const borderStyle: BorderStyleInterface = {
    borderWidth: 2,
    borderStyle: "solid",
    borderColor: "#cc5e95",
  };

  const avatarStyle: AvatarStyleInterface = {
    outerViewSpacing: 5,
    outerView: {
      borderWidth: 2,
      borderStyle: "dotted",
      borderColor: "blue",
    },
    border: borderStyle,
  };

  return (
    <>
      {callLog && (
        <CometChatParticipants
          call={callLog}
          data={callLog!.getParticipants()}
          avatarStyle={avatarStyle}
        ></CometChatParticipants>
      )}
    </>
  );
}

---

Functionality

These are a set of small functional customizations that allow you to fine-tune the overall experience of the component. With these, you can change text, set custom icons, and toggle the visibility of UI elements.

Here is a code snippet demonstrating how you can customize the functionality of the CallParticipants component.

App.tsx

import { CometChat, CometChatCalls } from "@cometchat/chat-sdk-react-native";
import {
  CometChatParticipants,
  DatePattern,
} from "@cometchat/chat-uikit-react-native";
import {
  CallLog,
  CallLogRequestBuilder,
} from "@cometchat/calls-sdk-react-native";

function App(): React.JSX.Element {
  const [loggedInUser, setLoggedInUser] = useState<CometChat.User>();
  const [callLog, setCallLog] = useState<CallLog>();
  useEffect(() => {
    //code
    CometChatUIKit.login({ uid: "uid" })
      .then(async (user: CometChat.User) => {
        setLoggedInUser(user);
        const callLogRequest = new CallLogRequestBuilder()
          .setLimit(1)
          .setCallStatus("cancelled")
          .setAuthToken(user!.getAuthToken())
          .build();

        callLogRequest
          .fetchNext()
          .then((callLogs: CallLog[]) => {
            setCallLog(callLogs[0]);
          })
          .catch(() => {
            //handle error
          });
      })
      .catch((error: any) => {
        //handle error
      });
  }, []);

  const datePattern: DatePattern = "dayDateFormat";

  return (
    <>
      {callLog && (
        <CometChatParticipants
          call={callLog}
          data={callLog!.getParticipants()}
          title="** Custom Title **"
          datePattern={datePattern}
        ></CometChatParticipants>
      )}
    </>
  );
}

iOS

Android

---

Below is a list of customizations along with corresponding code snippets

Property	Description	Code
title report	Used to set custom title	title?: string
emptyStateText report	Used to set custom empty state text	emptyStateText='Your Custom Empty State Text'
datePattern	Used to set custom date pattern	datePattern?: DatePattern
call	Call data object	call: CallLog;
showBackButton	Used to control the visibility of the back button	showBackButton?: boolean
BackButton	Used to set custom back icon	BackButton?: JSX.Element;
data	Used to set list of participants	data?: Participant[;

---

Advanced

For advanced-level customization, you can set custom views to the component. This lets you tailor each aspect of the component to fit your exact needs and application aesthetics. You can create and define your views, layouts, and UI elements and then incorporate those into the component.

---

ListItemView

With this property, you can assign a custom ListItem to the CallParticipants Component.

iOS

Android

App.tsx

import { CometChat, CometChatCalls } from "@cometchat/chat-sdk-react-native";
import {
  CometChatParticipants,
  CometChatAvatar,
} from "@cometchat/chat-uikit-react-native";
import {
  CallLog,
  CallLogRequestBuilder,
} from "@cometchat/calls-sdk-react-native";

function App(): React.JSX.Element {
  const [loggedInUser, setLoggedInUser] = useState<CometChat.User>();
  const [callLog, setCallLog] = useState<CallLog>();
  useEffect(() => {
    //code
    CometChatUIKit.login({ uid: "uid" })
      .then(async (user: CometChat.User) => {
        setLoggedInUser(user);
        const callLogRequest = new CallLogRequestBuilder()
          .setLimit(1)
          .setCallStatus("cancelled")
          .setAuthToken(user!.getAuthToken())
          .build();

        callLogRequest
          .fetchNext()
          .then((callLogs: CallLog[]) => {
            setCallLog(callLogs[0]);
          })
          .catch(() => {
            //handle error
          });
      })
      .catch((error: any) => {
        //handle error
      });
  }, []);

  const getCustomListItemView = (props: { participant?: CometChat.User }) => {
    let user = props.participant;
    if (!user) {
      return <></>;
    }

    return (
      <View style={viewStyle}>
        <CometChatAvatar
          image={user.getAvatar() ? { uri: user.getAvatar() } : undefined}
          name={user.getName()}
        />

        <View>
          <Text style={{ color: "black", fontWeight: "bold" }}>
            {user.getName()}
          </Text>
          {/* <Text style={{color: '#667'}}>{user.getStatus()}</Text> */}
        </View>
      </View>
    );
  };

  return (
    <>
      {callLog && (
        <CometChatParticipants
          call={callLog}
          data={callLog!.getParticipants()}
          ListItemView={getCustomListItemView}
        ></CometChatParticipants>
      )}
    </>
  );
}

---

SubtitleView

You can customize the subtitle view for each call Participant item to meet your requirements

iOS

Android

App.tsx

import { CometChat, CometChatCalls } from "@cometchat/chat-sdk-react-native";
import {
  CometChatParticipants,
  CometChatAvatar,
} from "@cometchat/chat-uikit-react-native";
import {
  CallLog,
  CallLogRequestBuilder,
} from "@cometchat/calls-sdk-react-native";

function App(): React.JSX.Element {
  const [loggedInUser, setLoggedInUser] = useState<CometChat.User>();
  const [callLog, setCallLog] = useState<CallLog>();
  useEffect(() => {
    //code
    CometChatUIKit.login({ uid: "uid" })
      .then(async (user: CometChat.User) => {
        setLoggedInUser(user);
        const callLogRequest = new CallLogRequestBuilder()
          .setLimit(1)
          .setCallStatus("cancelled")
          .setAuthToken(user!.getAuthToken())
          .build();

        callLogRequest
          .fetchNext()
          .then((callLogs: CallLog[]) => {
            setCallLog(callLogs[0]);
          })
          .catch(() => {
            //handle error
          });
      })
      .catch((error: any) => {
        //handle error
      });
  }, []);

  const getCustomSubtitleView = (props: { participant?: CometChat.User }) => {
    return <Text>** Custom Subtitle View **</Text>;
  };

  return (
    <>
      {callLog && (
        <CometChatParticipants
          call={callLog}
          data={callLog!.getParticipants()}
          SubtitleView={getCustomSubtitleView}
        ></CometChatParticipants>
      )}
    </>
  );
}

---

TailView

You can customize the tail view for each call participant item to meet your requirements

iOS

Android

App.tsx

import { CometChat, CometChatCalls } from "@cometchat/chat-sdk-react-native";
import {
  CometChatParticipants,
  CometChatAvatar,
} from "@cometchat/chat-uikit-react-native";
import {
  CallLog,
  CallLogRequestBuilder,
} from "@cometchat/calls-sdk-react-native";

function App(): React.JSX.Element {
  const [loggedInUser, setLoggedInUser] = useState<CometChat.User>();
  const [callLog, setCallLog] = useState<CallLog>();
  useEffect(() => {
    //code
    CometChatUIKit.login({ uid: "uid" })
      .then(async (user: CometChat.User) => {
        setLoggedInUser(user);
        const callLogRequest = new CallLogRequestBuilder()
          .setLimit(1)
          .setCallStatus("cancelled")
          .setAuthToken(user!.getAuthToken())
          .build();

        callLogRequest
          .fetchNext()
          .then((callLogs: CallLog[]) => {
            setCallLog(callLogs[0]);
          })
          .catch(() => {
            //handle error
          });
      })
      .catch((error: any) => {
        //handle error
      });
  }, []);

  const getCustomTailView = (param: any) => {
    return <Image style={{ tintColor: "#6851D6" }} source={Call}></Image>;
  };

  return (
    <>
      {callLog && (
        <CometChatParticipants
          call={callLog}
          data={callLog!.getParticipants()}
          TailView={getCustomTailView}
        ></CometChatParticipants>
      )}
    </>
  );
}

---

EmptyStateView

You can set a custom EmptyStateView using EmptyStateView to match the empty view of your app.

iOS

Android

App.tsx

import { CometChat, CometChatCalls } from "@cometchat/chat-sdk-react-native";
import {
  CometChatParticipants,
  CometChatAvatar,
} from "@cometchat/chat-uikit-react-native";
import {
  CallLog,
  CallLogRequestBuilder,
} from "@cometchat/calls-sdk-react-native";

function App(): React.JSX.Element {
  const [loggedInUser, setLoggedInUser] = useState<CometChat.User>();
  const [callLog, setCallLog] = useState<CallLog>();
  useEffect(() => {
    //code
    CometChatUIKit.login({ uid: "uid" })
      .then(async (user: CometChat.User) => {
        setLoggedInUser(user);
        const callLogRequest = new CallLogRequestBuilder()
          .setLimit(1)
          .setCallStatus("cancelled")
          .setAuthToken(user!.getAuthToken())
          .build();

        callLogRequest
          .fetchNext()
          .then((callLogs: CallLog[]) => {
            setCallLog(callLogs[0]);
          })
          .catch(() => {
            //handle error
          });
      })
      .catch((error: any) => {
        //handle error
      });
  }, []);

  const emptyViewStyle: StyleProp<ViewStyle> = {
    flex: 1,
    alignItems: "center",
    justifyContent: "center",
    padding: 10,
    borderColor: "black",
    borderWidth: 1,
    backgroundColor: "#E8EAE9",
    marginLeft: 2,
    marginRight: 2,
    marginBottom: 30,
  };

  const getEmptyStateView = () => {
    return (
      <View style={emptyViewStyle}>
        <Text style={{ fontSize: 80, color: "black" }}>Empty</Text>
      </View>
    );
  };

  return (
    <>
      {callLog && (
        <CometChatParticipants
          call={callLog}
          data={callLog!.getParticipants()}
          EmptyStateView={getEmptyStateView}
        ></CometChatParticipants>
      )}
    </>
  );
}

---