Python: .Net: ADR for realtime

[eavanvalkenburg]

Motivation and Context

ADR describing the preliminary design for realtime API's.
As these API's themselves are in preview, we might have to deal with incompatible changes down the road.

Description

Contribution Checklist

• The code builds clean without any errors or warnings
• The PR follows the SK Contribution Guidelines and the pre-submission formatting script raises no violations
• All unit tests pass, and I have added new tests where possible
• I didn't break anyone 😄

[RogerBarreto]

Some observations.

1. Should we instead of having specialized Image/Audio events, have ContentEvent with the specific content within it?

I'm asking that because in M.E.AI we dropped the Image and Audio specialization in favor of Data for any binary information.

2. I would suggest that all events should be ServiceEvent specializations. Following also @westey-m point, I would suggest having the inner_event|raw_representation for the base ServiceEvent where this would be the way to get the event name, not fully sure of exposing the underlying service event name as part of the abstraction.

[eavanvalkenburg]

I can see the logic in this, however these events are going both ways, you also create them to send data to the service and not all of those have content, some are empty, but you just call with the right service event type, so that isn't always the way to get the event name!

[eavanvalkenburg]

and only having a content event and then not having a different internal type for image or audio (as they are both data), means that you would have to dig into the actual event or match on the event type, that seems like a worse experience