Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
mapluisch authored Oct 6, 2024
1 parent 32ab331 commit bdcf929
Showing 1 changed file with 17 additions and 6 deletions.
23 changes: 17 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,21 +13,32 @@ On October 1st, [OpenAI introduced their Realtime API](https://openai.com/index/
This (WIP) project integrates the API into a Unity application, allowing users to build low-latency, multi-modal conversational apps that support both text and audio input/output, as well as function calling (via [OpenAI Realtime API documentation](https://platform.openai.com/docs/guides/realtime)).

Specifically, this package allows you to integrate real-time low-latency voice conversations with OpenAI's TTS/STT conversational models (via push-to-talk or VAD).
I've integrated natural speech interruption handling and (a super dumb) client-side VAD.

Tested with Unity version 2022.3.45f1 (on macOS, but it should work on every platform that supports `Newtonsoft.Json`).

## Demo Video (coming soon)
## Demos
> disclaimer, I liked the UI used by OpenAI [in this project](https://github.com/openai/openai-realtime-console/tree/main), as you can see :)
### Standard conversation
https://github.com/user-attachments/assets/73b69bd7-dae8-4d49-8f7f-02fa32d9a955

### Setup (coming soon)
### Interruption example
https://github.com/user-attachments/assets/88fd83eb-e285-488d-8308-a40a48a7307f


### Setup
1. Download the latest release `.unitypackage`.
2. Import it into your own project, e.g., via `Assets > Import Package`.
3. Either open the `DemoScene` scene or add the necessary Prefabs to your own scene.
3. Go to Package Manager, click on the `+`, then `Add package by name`, and add `com.unity.nuget.newtonsoft-json`.
4. Either open the `DemoScene` scene or add the necessary Prefabs to your own scene.

### Using OpenAI Realtime API in your own scene
1. Add the `RealtimeAPIWrapper` Prefab to your scene.
2. Add your OpenAI API key to the `RealtimeAPIWrapper` Prefab.
1. Add the `RealtimeAPI` Prefab to your scene.
2. Add your OpenAI API key to the `RealtimeAPI` Prefab.
3. Optional: Add the `DemoIntegration` Prefab to a Canvas within your scene or open up the `DemoScene` to see an integration example.
4. Start sending and receiving real-time audio with OpenAI's Realtime API - either by pressing on the button to start and stop recording, or by using the Space-key for push-to-talk.
4. Reference the `AudioController`, nested inside the `RealtimeAPI` Prefab, and call `audioController.StartRecording()` and `audioController.StopRecording()` to start resp. stop a microphone recording (as push-to-talk).
5. Bind a button or key to both actions - within my `DemoIntegration`, the spacebar can also be used as push-to-talk key.
6. The audio is automatically recorded, converted to PCM16 and Base64, sent via the WebSocket connection to the API, and the received chunks and written transcript are handled and served via events.

### Action Events
The `RealtimeAPIWrapper` component triggers various **Action** events, enabling you to handle key stages of the real-time session. Below is a list of available Action events:
Expand Down

0 comments on commit bdcf929

Please sign in to comment.