okapilabLogFiles

Introduction

This is an extension for the wonderful software GPTAvatar created by Seth Robinson, https://github.com/SethRobinson/GPTAvatar. GPTAvatar is a free open-source software that allows creating AI-based avatars with Unity.

This class

The class LogFiles is part of Maximilian C. Fink's OKAPILabExtensions for GPTAvatar. The class allows to create logfiles for educational/psychological/other research when using GPTAvatar. In order to create good logfiles, the xAPI logfile standard is used: https://xapi.com/. This extension can be used in the desktop versions of GPTAvatar. It has been tested on Windows and could potentially also work on MacOS and Linux. It will probably not work well on WebGL builds and on builds for Android/IOS. At least files will be written to a different file path that's hard to discover.

Setting up this extension

To set up this extension, the following steps have to be done:

1. Copy this file in Unity somehwere under your assets (e.g., in a separate folder OKAPILabExtensions)
2. Click in the Unity hierarchy on "Canvas" and open the child object "Panel"
3. Click on the "Panel" component on "Add Component" and then type/select "LogFiles" -> this adds the C# file Now everything should run as intended. No further changes should be neccessary. Try it in play mode and make builds :)

Using this extension in GPTAvatar and finding and formatting the logfile(s)

When using GPTAvatar the following has to be done

1. Enter the PIN/code of the user for whom you want to create logfile in the textbox that appears upon start and presse enter -> this will be the file name of the created .csv
2. After using GPTAvatar, the log file will be saved in this folder C:\Users\USERNAME\AppData\LocalLow\Robinson Technologies\GPTAvatar
   The relevant folder should look like this (Tester was the user name I entered)
3. Search for the user name
4. For correct formatting of the .csv file, click on column A. Then click on data -> text in columns -> separated -> comma as seperator

The resulting logfiles should look like this in Excel

Using GPTAvatar for research and collaboration opportunities

If you use GPTAvatar for psychological/educational research, please either cite our article http://www.dx.doi.org/10.3389/feduc.2024.1416307 or Seth Robinson's github repository. If you need more code modification or want to collaborate for scientific purposes, please reach out to Maximilian C. Fink ([email protected]). I'm always happy to help and conduct research together :)