Feature/communication calling server preview (#21724)

* Small fix.

* Rename audio_file_uri to audio_url

* Remove validation.

* rename get_participants() to list_participants()

* change get_audio_routing_groups to list_audio_routing_groups

* change transfer_call to transfer

* Use latest swagger.

* change loop to is_looped

* Use kwarg for optional parameters.

* Flatten options object and fix tests.

* Fix left over warning in the api view.

* Update description for certains apis that cause ambiguity.

* Fix pylint build and remove REST model.

Author: zihzhan-msft

sdk/communication/azure-communication-callingserver/README.md

@@ -122,12 +122,12 @@ from azure.communication.callingserver import (
     )
 
 play_audio_result = await call_connection_async.play_audio(
-    audio_file_uri="<audio-file-uri>",
+    audio_url="<audio_url>",
     play_audio_options=PlayAudioOptions"<...>"))
     )
 ```
 
-- `audio_file_uri`: The uri of the audio file.
+- `audio_url`: The uri of the audio file.
 - `play_audio_options`: The playAudio options.
 
 ### Cancel all media operations in the call connection
@@ -164,7 +164,7 @@ call_connection = await callingserver_client.join_call(
 
 - `call_locator`: The callLocator contains the call id.
 - `source`: The source identity which join the call.
-- `play_audio_options`: The joinCall options.
+- `join_call_options`: The joinCall options.
 
 ### Add participant with calllocator to the server call
 Once the call is establised, the `add_participant` method can be invoked:
@@ -217,13 +217,13 @@ from azure.communication.callingserver import (
 call_locator = ServerCallLocator("<server-call-id>")
 play_audio_result = await callingserver_client.play_audio(
     call_locator=call_locator,
-    audio_file_uri="<audio-file-uri>",
+    audio_url="<audio_url>",
     play_audio_options=PlayAudioOptions"<...>"))
     )
 ```
 
 - `call_locator`: The callLocator contains the call id.
-- `audio_file_uri`: The uri of the audio file.
+- `audio_url`: The uri of the audio file.
 - `play_audio_options`: The playAudio options.
 
 ### Cancel media operations with calllocator in the server call
@@ -241,7 +241,7 @@ cancel_all_media_operations_result = await call_connection_async.cancel_media_op
 )
 ```
 
-- `audio_file_uri`: The callLocator contains the call id.
+- `call_locator`: The callLocator contains the call id.
 - `media_operation_id`: The operationId of the media operation to cancel.
 
 

sdk/communication/azure-communication-callingserver/azure/communication/callingserver/__init__.py

@@ -9,19 +9,14 @@
 from ._call_connection import CallConnection
 from ._callingserver_client import CallingServerClient
 from ._generated.models import (AudioRoutingMode, AddParticipantResult, CallConnectionProperties,
-                                CallRejectReason, CreateCallRequest, PhoneNumberIdentifierModel,
-                                PlayAudioRequest, PlayAudioResult, CallParticipant,
+                                CallRejectReason, PlayAudioResult, CallParticipant,
                                 CallMediaType, CallingEventSubscriptionType,
                                 CallingOperationStatus, CallConnectionStateChangedEvent,
                                 ToneReceivedEvent, ToneInfo,
-                                PlayAudioResultEvent, CommunicationIdentifierModel,
-                                CommunicationUserIdentifierModel, AddParticipantResultEvent,
+                                PlayAudioResultEvent, AddParticipantResultEvent,
                                 CallConnectionState, ToneValue, AnswerCallResult, AudioRoutingGroupResult,
-                                CreateAudioRoutingGroupResult)
+                                CreateAudioRoutingGroupResult, TransferCallResult)
 from ._models import (
-    CreateCallOptions,
-    JoinCallOptions,
-    PlayAudioOptions,
     CallLocator,
     GroupCallLocator,
     ServerCallLocator,
@@ -39,16 +34,10 @@
     'CallingServerClient',
     'CommunicationIdentifier',
     'CommunicationUserIdentifier',
-    'CreateCallOptions',
-    'CreateCallRequest',
     'CallingEventSubscriptionType',
-    'JoinCallOptions',
     'CallMediaType',
     'CallingOperationStatus',
     'PhoneNumberIdentifier',
-    'PhoneNumberIdentifierModel',
-    'PlayAudioOptions',
-    'PlayAudioRequest',
     'PlayAudioResult',
     'CallLocator',
     'GroupCallLocator',
@@ -57,14 +46,13 @@
     'ToneReceivedEvent',
     'ToneInfo',
     'PlayAudioResultEvent',
-    'CommunicationIdentifierModel',
-    'CommunicationUserIdentifierModel',
     'AddParticipantResultEvent',
     'CallConnectionState',
     'ToneValue',
     'CallingServerEventType',
     'AnswerCallResult',
     'AudioRoutingGroupResult',
-    'CreateAudioRoutingGroupResult'
+    'CreateAudioRoutingGroupResult',
+    'TransferCallResult'
 ]
 __version__ = VERSION