Skip to main content
Version: v4

Call Log Recordings

Overview​

The CometChatCallLogRecordings is a Component that shows a paginated list of recordings of a particular call. This allows the user to see all the recordings along with the duration as well as a download link using which one can download the recording.

Image

The Call Log Recordings is comprised of the following components:

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

Usage​

Integration​

import {
  CallLog,
  CallLogRequestBuilder,
} from "@cometchat/calls-sdk-javascript";
import {
  CometChatCallLogRecordings,
  CometChatUIKit,
} from "@cometchat/chat-uikit-react";
import React from "react";

const CallLogRecordingsDemo = () => {
  const [callLog, setCallLog] = React.useState<CallLog>();

  React.useEffect(() => {
    //code
    CometChatUIKit.login("uid")
      .then(async (user: CometChat.User) => {
        const callLogRequest = new CallLogRequestBuilder()
          .setLimit(10)
          .setAuthToken(user!.getAuthToken())
          .build();

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

export default CallLogRecordingsDemo;

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. onBackClick​

onBackClick is triggered when you click the Back button Icon of the Call Log Participants component. It does not have a default behavior. However, you can override its behavior using the following code snippet.

CallLogRecordingsDemo.tsx
import {
  CallLog,
  CallLogRequestBuilder,
} from "@cometchat/calls-sdk-javascript";
import {
  CometChatCallLogRecordings,
  CometChatUIKit,
} from "@cometchat/chat-uikit-react";
import React from "react";

const CallLogRecordingsDemo = () => {
  const [callLog, setCallLog] = React.useState<CallLog>();

  React.useEffect(() => {
    //code
    CometChatUIKit.login("uid")
      .then(async (user: CometChat.User) => {
        const callLogRequest = new CallLogRequestBuilder()
          .setLimit(10)
          .setAuthToken(user!.getAuthToken())
          .build();

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

  const handleOnBackClick = () => {
    //your custom on back click action
  };

  return (
    <CometChatCallLogRecordings
      call={callLog}
      onBackClick={handleOnBackClick}
    />
  );
};

export default CallLogRecordingsDemo;
2. onItemClick​

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

CallLogRecordingsDemo.tsx
import {
  CallLog,
  CallLogRequestBuilder,
} from "@cometchat/calls-sdk-javascript";
import {
  CometChatCallLogRecordings,
  CometChatUIKit,
} from "@cometchat/chat-uikit-react";
import React from "react";

const CallLogRecordingsDemo = () => {
  const [callLog, setCallLog] = React.useState<CallLog>();

  React.useEffect(() => {
    //code
    CometChatUIKit.login("uid")
      .then(async (user: CometChat.User) => {
        const callLogRequest = new CallLogRequestBuilder()
          .setLimit(10)
          .setAuthToken(user!.getAuthToken())
          .build();

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

  const handleOnItemClick = () => {
    //your custom on item click action
  };

  return (
    <CometChatCallLogRecordings
      call={callLog}
      onItemClick={handleOnItemClick}
    />
  );
};

export default CallLogRecordingsDemo;
2. onDownloadClick​

onDownloadClick is triggered when you click on the download of the of the Call Log Recordings component. you can override its behavior using the following code snippet.

CallLogRecordingsDemo.tsx
import {
  CallLog,
  CallLogRequestBuilder,
} from "@cometchat/calls-sdk-javascript";
import {
  CometChatCallLogRecordings,
  CometChatUIKit,
} from "@cometchat/chat-uikit-react";
import React from "react";

const CallLogRecordingsDemo = () => {
  const [callLog, setCallLog] = React.useState<CallLog>();

  React.useEffect(() => {
    //code
    CometChatUIKit.login("uid")
      .then(async (user: CometChat.User) => {
        const callLogRequest = new CallLogRequestBuilder()
          .setLimit(10)
          .setAuthToken(user!.getAuthToken())
          .build();

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

  const handleOnDownloadClick = () => {
    //your custom on back click action
  };

  return (
    <CometChatCallLogRecordings
      call={callLog}
      onDownloadClick={handleOnDownloadClick}
    />
  );
};

export default CallLogRecordingsDemo;

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 Call Log Recordings 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 Call Log Recordings does not produce any events.

Customization​

To fit your app's design requirements, you have the ability to customize the appearance of the CallLogRecordings 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. CallLogRecordings Style​

To customize the appearance, you can assign a CallLogRecordingsStyle object to the Call Log Recordings component.

Example

In this example, we are employing the CallLogRecordingsStyle.

CallLogRecordingsDemo.tsx
import {
  CallLog,
  CallLogRequestBuilder,
} from "@cometchat/calls-sdk-javascript";
import {
  CometChatCallLogRecordings,
  CometChatUIKit,
  CallLogRecordingsStyle,
} from "@cometchat/chat-uikit-react";
import React from "react";

const CallLogRecordingsDemo = () => {
  const [callLog, setCallLog] = React.useState<CallLog>();

  React.useEffect(() => {
    //code
    CometChatUIKit.login("uid")
      .then(async (user: CometChat.User) => {
        const callLogRequest = new CallLogRequestBuilder()
          .setLimit(10)
          .setAuthToken(user!.getAuthToken())
          .build();

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

  const callLogRecordingsStyle = new CallLogRecordingsStyle({
    background: "#f8f5ff",
    titleColor: "#6f3ae0",
    dateTextColor: "#6f34ed",
    recordingDurationColor: "#6f34ed",
  });

  return (
    <CometChatCallLogRecordings
      call={callLog}
      callLogRecordingsStyle={callLogRecordingsStyle}
    />
  );
};

export default CallLogRecordingsDemo;
Image

The following properties are exposed by CallLogRecordingsStyle:

PropertyDescriptionCode
borderUsed to set borderborder?: string,
borderRadiusUsed to set border radiusborderRadius?: string;
backgroundUsed to set background colourbackground?: string;
heightUsed to set heightheight?: string;
widthUsed to set widthwidth?: string;
titleFontUsed to set title fonttitleFont?: string,
titleColorUsed to set title colortitleColor?: string;
backIconTintUsed to set back icon tintbackIconTint?: string;
downloadIconTintUsed to set download icon tintdownloadIconTint?: string;
recordingDurationFontUsed to set recording duration fontrecordingDurationFont?: string;
recordingDurationColorUsed to set recording duration colorrecordingDurationColor?: string;
dateTextFontUsed to set date text fontdateTextFont?: string;
dateTextColorUsed to set date text colordateTextColor?: string;
2. ListItem Style​

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

CallLogRecordingsDemo.tsx
import {
  CallLog,
  CallLogRequestBuilder,
} from "@cometchat/calls-sdk-javascript";
import {
  CometChatCallLogRecordings,
  CometChatUIKit,
  ListItemStyle,
} from "@cometchat/chat-uikit-react";
import React from "react";

const CallLogRecordingsDemo = () => {
  const [callLog, setCallLog] = React.useState<CallLog>();

  React.useEffect(() => {
    //code
    CometChatUIKit.login("uid")
      .then(async (user: CometChat.User) => {
        const callLogRequest = new CallLogRequestBuilder()
          .setLimit(10)
          .setAuthToken(user!.getAuthToken())
          .build();

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

  const listItemStyle = new ListItemStyle({
    background: "#f8f5ff",
    activeBackground: "#6f34ed",
    titleColor: "#6f34ed",
  });

  return (
    <CometChatCallLogRecordings call={callLog} listItemStyle={listItemStyle} />
  );
};

export default CallLogRecordingsDemo;

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 Call Log Recordings component.

CallLogRecordingsDemo.tsx
import {
  CallLog,
  CallLogRequestBuilder,
} from "@cometchat/calls-sdk-javascript";
import {
  CometChatCallLogRecordings,
  CometChatUIKit,
  DatePatterns,
} from "@cometchat/chat-uikit-react";
import React from "react";

const CallLogRecordingsDemo = () => {
  const [callLog, setCallLog] = React.useState<CallLog>();

  React.useEffect(() => {
    //code
    CometChatUIKit.login("uid")
      .then(async (user: CometChat.User) => {
        const callLogRequest = new CallLogRequestBuilder()
          .setLimit(10)
          .setAuthToken(user!.getAuthToken())
          .build();

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

  return (
    <CometChatCallLogRecordings
      call={callLog}
      title="Your Custom Title"
      datePattern={DatePatterns.DateTime}
      downloadIconUrl="Your Custom Download Icon"
    />
  );
};

export default CallLogRecordingsDemo;

Default:

Image

Custom:

Image

Below is a list of customizations along with corresponding code snippets

PropertyDescriptionCode
titleUsed to set custom titletitle='Your Custom Title'
backIconUrlUsed to set custom back icon URLbackIconUrl='custom back icon url'
downloadIconUrlUsed to set custom download icon URLdownloadIconUrl='custom download icon url'
datePatternUsed to set custom date patterndatePattern={DatePatterns.DayDateTime}
callCall data objectcall: CallLog;
hideDownloadButtonused to control the visibility of the download button in the user interface.hideDownloadButton={true}

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 Call Log Recordings Component.

listItemView = { getListItemView };

Example

Default:

Image

Custom:

Image
CallLogRecordingsDemo.tsx
import {
  CallLog,
  CallLogRequestBuilder,
  Recording,
} from "@cometchat/calls-sdk-javascript";
import {
  CometChatCallLogRecordings,
  CometChatUIKit,
} from "@cometchat/chat-uikit-react";
import React from "react";

const CallLogRecordingsDemo = () => {
  const [callLog, setCallLog] = React.useState<CallLog>();

  React.useEffect(() => {
    //code
    CometChatUIKit.login("uid")
      .then(async (user: CometChat.User) => {
        const callLogRequest = new CallLogRequestBuilder()
          .setLimit(10)
          .setAuthToken(user!.getAuthToken())
          .build();

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

  const getListItemView = (recording: Recording) => {
    return (
      <div
        style={{
          border: "1px solid #E0E0E0",
          borderRadius: "10px",
          background: "#f8f7ff",
          color: "#000000",
          padding: "10px",
          textAlign: "left",
        }}
      >
        {recording.getEndTime()}
      </div>
    );
  };

  return (
    <CometChatCallLogRecordings call={callLog} listItemView={getListItemView} />
  );
};

export default CallLogRecordingsDemo;

SubtitleView​

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

subtitleView = { getSubtitleView };

Default:

Image

Custom:

Image
CallLogRecordingsDemo.tsx
import {
  CallLog,
  CallLogRequestBuilder,
  Recording,
} from "@cometchat/calls-sdk-javascript";
import {
  CometChatCallLogRecordings,
  CometChatUIKit,
} from "@cometchat/chat-uikit-react";
import React from "react";

const CallLogRecordingsDemo = () => {
  const [callLog, setCallLog] = React.useState<CallLog>();

  React.useEffect(() => {
    //code
    CometChatUIKit.login("uid")
      .then(async (user: CometChat.User) => {
        const callLogRequest = new CallLogRequestBuilder()
          .setLimit(10)
          .setAuthToken(user!.getAuthToken())
          .build();

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

  const getSubtitleView = (recording: Recording): JSX.Element => {
    return (
      <div
        style={{
          display: "flex",
          alignItems: "left",
          padding: "2px",
          fontSize: "10px",
        }}
      >
        <div style={{ color: "gray", fontSize: "15px" }}>
          {recording.getDuration()}
        </div>
      </div>
    );
  };

  return (
    <CometChatCallLogRecordings call={callLog} subtitleView={getSubtitleView} />
  );
};

export default CallLogRecordingsDemo;

TailView​

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

tailView = { getTailView };

Default:

Image

Custom:

Image
CallLogRecordingsDemo.tsx
import {
  CallLog,
  CallLogRequestBuilder,
  Recording,
} from "@cometchat/calls-sdk-javascript";
import {
  CometChatCallLogRecordings,
  CometChatUIKit,
} from "@cometchat/chat-uikit-react";
import React from "react";

const CallLogRecordingsDemo = () => {
  const [callLog, setCallLog] = React.useState<CallLog>();

  React.useEffect(() => {
    //code
    CometChatUIKit.login("uid")
      .then(async (user: CometChat.User) => {
        const callLogRequest = new CallLogRequestBuilder()
          .setLimit(10)
          .setAuthToken(user!.getAuthToken())
          .build();

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

  function getTailView(recording: Recording): JSX.Element {
    return (
      <div style={{ color: "#e8e4f7", padding: "5px" }}>
        {recording.getDuration()}
      </div>
    );
  }

  return <CometChatCallLogRecordings call={callLog} tailView={getTailView} />;
};

export default CallLogRecordingsDemo;