[OpenAI] Azure OpenAI realtime client library for Java first version

[jpalvarezl]

Description

Proposal for the Azure OpenAI Realtime Audio Java client library. The client library is based of the TSP spec found here. We want to release this library only in the dev feed for the forseeable future.

• Manually created APIView link
• Web socket protocol layer ported over from the webPubSubClient library
• A more detailed documentation of the OpenAI layer of this client library can be found here
• Test coverage parity with the .NET analogous library. (https://github.com/openai/openai-dotnet/tree/main/tests/RealtimeConversation)
• Sample coverage parity with the Python library (https://github.com/Azure-Samples/aoai-realtime-audio-sdk/tree/main/python/samples)

Remaining TODOs

This client libary related

• More thorough testing of the webSocketClient layer
• Figure out test recordings. Currently we only have LIVE tests with resources which are heavily restricted. We may need to disable tests running in the pipeline for now.
• Once the roadmap for support for this libabry is clear. Define the release vehicle. For now we just ship in the dev feed.
• Populate the ReadmeSamples.java with relevant code snippets.
• Add instructions for users to set themselves up with the dev feed in the README

TSP related

• Issues this bug for code gen. There is a small issue with how constructors are being generated for RealtimeResponseFunctionCallItem, RealtimeResponseFunctionCallOutputItem and RealtimeResponseMessageItem. I have filed an issue for this here: [Bug]: Subclass conctructor generation contains unexpected String object field microsoft/typespec#5157
• There is another issue with the RealtimeServerVadTurnDetection which attempts to serialize the values for prefixPaddingMs and silenceDurationMs as String I have opened another issue asking about this:[Bug]: Unexpected field as JSON String instead of number microsoft/typespec#5158
• After code gen, since this is a webSocket client library, we can't really utilize what is generated from the operation defined in TSP. Therefore, there is still the need to manually remove the following files:

src/main/java/com/azure/ai/openai/realtime/OpenAIAsyncClient.java
src/main/java/com/azure/ai/openai/realtime/OpenAIClient.java
src/main/java/com/azure/ai/openai/realtime/OpenAIClientBuilder.java
src/main/java/com/azure/ai/openai/realtime/implementation/OpenAIClientImpl.java
src/main/java/com/azure/ai/openai/realtime/implementation/RealtimesImpl.java

[azure-sdk]

API change check

APIView has identified API level changes in this PR and created following API reviews.

com.azure:azure-ai-openai-realtime