Rychlý start: Správa hovoru v místnosti

Úvod

Během volání místnosti Azure Communication Services (ACS) můžete hovor spravovat pomocí volání sad SDK nebo sad SDK pro automatizaci volání nebo obojího. Při volání místnosti můžete řídit akce v hovoru pomocí rolí přiřazených účastníkům i vlastnostem nakonfigurovaným v místnosti. Role účastníka řídí možnosti povolené pro jednotlivé účastníky, zatímco vlastnosti místnosti platí pro volání místnosti jako celek.

Volání sad SDK

Volání sady SDK je knihovna volání na straně klienta, která umožňuje účastníkům hovoru v místnosti provádět několik operací v hovoru, jako je sdílení obrazovky, zapnutí/vypnutí videa, ztlumení nebo zrušení ztlumení atd. Úplný seznam funkcí najdete v tématu Přehled volání sady SDK.

Možnosti můžete řídit na základě rolí přiřazených účastníkům hovoru. Sdílení obrazovky může například sdílet jenom prezentující. Informace o rolích a oprávněních účastníků najdete v tématu Koncepty místností.

Volání sad SDK pro automatizaci

Sada SDK pro automatizaci volání je knihovna na straně serveru, která správcům umožňuje spravovat probíhající hovor v místnosti v centrálním a řízeném prostředí. Na rozdíl od volání sady SDK jsou operace sady SDK pro automatizaci volání nezávislé na rolích. Správce volání proto může jménem účastníků hovoru provést několik operací v hovoru.

Následující seznamy popisují běžné akce v rámci volání dostupné v hovoru v místnosti.

Připojení k hovoru do místnosti

Automatizace volání se musí připojit k existujícímu volání místnosti před provedením jakýchkoli operací volání. ConnectFailed Události CallConnected jsou vyvolány pomocí mechanismů zpětného volání, které indikují, jestli byla operace připojení úspěšná nebo selhala.

csharp

Uri callbackUri = new Uri("https://<myendpoint>/Events"); //the callback endpoint where you want to receive subsequent events
CallLocator roomCallLocator = new RoomCallLocator("<RoomId>");
ConnectCallResult response = await client.ConnectAsync(roomCallLocator, callbackUri);

Java

String callbackUri = "https://<myendpoint>/Events"; //the callback endpoint where you want to receive subsequent events
CallLocator roomCallLocator =  new RoomCallLocator("<RoomId>");
ConnectCallResult response = client.connectCall(roomCallLocator, callbackUri).block();

JavaScript

const roomCallLocator = { kind: "roomCallLocator", id: "<RoomId>" };
const callbackUri = "https://<myendpoint>/Events"; // the callback endpoint where you want to receive subsequent events 
const response = await client.connectCall(roomCallLocator, callbackUri);

Python

callback_uri = "https://<myendpoint>/Events"  # the callback endpoint where you want to receive subsequent events
room_call_locator = RoomCallLocator("<room_id>")
call_connection_properties = client.connect_call(call_locator=room_call_locator, callback_url=callback_uri)

Po úspěšném připojení k volání do místnosti se prostřednictvím identifikátoru URI zpětného volání CallConnect zobrazí upozornění na událost. Podle potřeby můžete callConnectionId načíst připojení k hovoru v místnosti. Následující ukázkové fragmenty kódu používají callConnectionId k předvedení této funkce.

Přidání účastníka veřejné telefonní sítě

Pomocí automatizace hovorů můžete vytočit číslo veřejné telefonní sítě a přidat účastníka do hovoru do místnosti. Musíte ale nastavit místnost tak, aby povolovala možnost vytáčení do veřejné telefonní sítě (EnabledPSTNDialout nastavená na true) a prostředek služby Azure Communication Services musí mít zřízené platné telefonní číslo.

Další informace najdete v tématu Rychlý start k místnostem.

csharp

var callerIdNumber = new PhoneNumberIdentifier("+16044561234"); // This is the ACS-provisioned phone number for the caller  
var callThisPerson = new CallInvite(new PhoneNumberIdentifier("+16041234567"), callerIdNumber); // The target phone number to dial out to
CreateCallResult response = await client.GetCallConnection(callConnectionId).AddParticipantAsync(callThisPerson);

Java

PhoneNumberIdentifier callerIdNumber = new PhoneNumberIdentifier("+16044561234"); // This is the ACS-provisioned phone number for the caller
CallInvite callInvite = new CallInvite(new PhoneNumberIdentifier("+16041234567"), callerIdNumber); // The phone number participant to dial out to
AddParticipantOptions addParticipantOptions = new AddParticipantOptions(callInvite);
Response<AddParticipantResult> addParticipantResultResponse = client.getCallConnectionAsync(callConnectionId)
    .addParticipantWithResponse(addParticipantOptions).block();

JavaScript

const callInvite = {
    targetParticipant: { phoneNumber: "+18008008800" }, // The phone number participant to dial out to
    sourceCallIdNumber: { phoneNumber: "+18888888888" } // This is the ACS-provisioned phone number for the caller
};
const response = await client.getCallConnection(callConnectionId).addParticipant(callInvite);

Python

caller_id_number = PhoneNumberIdentifier(
    "+18888888888"
) # TThis is the ACS-provisioned phone number for the caller
target = PhoneNumberIdentifier("+18008008800"), # The phone number participant to dial out to

call_connection_client = call_automation_client.get_call_connection(
    "call_connection_id"
)
result = call_connection_client.add_participant(
    target,
    operation_context="Your context",
    operationCallbackUrl="<url_endpoint>"
)

Odebrání účastníka veřejné telefonní sítě

csharp

var removeThisUser = new PhoneNumberIdentifier("+16044561234");

// Remove a participant from the call with optional parameters
var removeParticipantOptions = new RemoveParticipantOptions(removeThisUser)
{
    OperationContext = "operationContext",
    OperationCallbackUri = new Uri("uri_endpoint"); // Sending event to a non-default endpoint
}

RemoveParticipantsResult result = await client.GetCallConnection(callConnectionId).RemoveParticipantAsync(removeParticipantOptions);

Java

CommunicationIdentifier removeThisUser = new PhoneNumberIdentifier("+16044561234");
RemoveParticipantOptions removeParticipantOptions = new RemoveParticipantOptions(removeThisUser)
                .setOperationContext("<operation_context>")
                .setOperationCallbackUrl("<url_endpoint>");
Response<RemoveParticipantResult> removeParticipantResultResponse = client.getCallConnectionAsync(callConnectionId)
    .removeParticipantWithResponse(removeParticipantOptions);

JavaScript

const removeThisUser = { phoneNumber: "+16044561234" };
const removeParticipantResult = await client.getCallConnection(callConnectionId).removeParticipant(removeThisUser);

Python

remove_this_user = PhoneNumberIdentifier("+16044561234")
call_connection_client = call_automation_client.get_call_connection(
    "call_connection_id"
)
result = call_connection_client.remove_participant(remove_this_user, operation_context="Your context", operationCallbackUrl="<url_endpoint>")

Odeslat DTMF

Pošlete externímu účastníkovi seznam tónů DTMF.

csharp

var tones = new DtmfTone[] { DtmfTone.One, DtmfTone.Two, DtmfTone.Three, DtmfTone.Pound }; 
var sendDtmfTonesOptions = new SendDtmfTonesOptions(tones, new PhoneNumberIdentifier(calleePhonenumber))
{ 
	OperationContext = "dtmfs-to-ivr" 
}; 

var sendDtmfAsyncResult = await callAutomationClient.GetCallConnection(callConnectionId).GetCallMedia().SendDtmfTonesAsync(sendDtmfTonesOptions);

Java

List<DtmfTone> tones = Arrays.asList(DtmfTone.ONE, DtmfTone.TWO, DtmfTone.THREE, DtmfTone.POUND); 
SendDtmfTonesOptions options = new SendDtmfTonesOptions(tones, new PhoneNumberIdentifier(c2Target)); 
options.setOperationContext("dtmfs-to-ivr"); 
client.getCallConnectionAsync(callConnectionId)
	.getCallMediaAsync() 
	.sendDtmfTonesWithResponse(options) 
	.block(); 

JavaScript

const tones = [DtmfTone.One, DtmfTone.Two, DtmfTone.Three];
const sendDtmfTonesOptions: SendDtmfTonesOptions = {
	operationContext: "dtmfs-to-ivr"
};
const result: SendDtmfTonesResult = await client.getCallConnection(callConnectionId)
	.getCallMedia()
	.sendDtmfTones(tones, {
		phoneNumber: c2Target
	}, sendDtmfTonesOptions);
console.log("sendDtmfTones, result=%s", result);

Python

tones = [DtmfTone.ONE, DtmfTone.TWO, DtmfTone.THREE]
call_connection_client = call_automation_client.get_call_connection(
    "call_connection_id"
)

result = call_connection_client.send_dtmf_tones(
	tones = tones,
	target_participant = PhoneNumberIdentifier(c2_target),
	operation_context = "dtmfs-to-ivr")

Záznam hovoru

Místnosti Azure Communication Services podporují možnosti nahrávání, včetně start, stoppause, resumea tak dále, poskytované automatizací volání. Podívejte se na následující fragmenty kódu pro spuštění, zastavení, pozastavení nebo obnovení záznamu v hovoru v místnosti. Úplný seznam akcí najdete v tématu Záznam automatizace volání.

csharp

// Start recording
StartRecordingOptions recordingOptions = new StartRecordingOptions(new ServerCallLocator("<ServerCallId>"))
{
   RecordingContent = RecordingContent.Audio,
   RecordingChannel = RecordingChannel.Unmixed,
   RecordingFormat = RecordingFormat.Wav,
   RecordingStateCallbackUri = new Uri("<CallbackUri>"),
   RecordingStorage = RecordingStorage.CreateAzureBlobContainerRecordingStorage(new Uri("<YOUR_STORAGE_CONTAINER_URL>"))
};
Response<RecordingStateResult> response = await callAutomationClient.GetCallRecording()
.StartAsync(recordingOptions);

// Pause recording using recordingId received in response of start recording.
var pauseRecording = await callAutomationClient.GetCallRecording ().PauseAsync(recordingId);

// Resume recording using recordingId received in response of start recording.
var resumeRecording = await callAutomationClient.GetCallRecording().ResumeAsync(recordingId);

// Stop recording using recordingId received in response of start recording.
var stopRecording = await callAutomationClient.GetCallRecording().StopAsync(recordingId);

Java

// Start recording
StartRecordingOptions recordingOptions = new StartRecordingOptions(new ServerCallLocator("<serverCallId>"))
                    .setRecordingChannel(RecordingChannel.UNMIXED)
                    .setRecordingFormat(RecordingFormat.WAV)
                    .setRecordingContent(RecordingContent.AUDIO)
                    .setRecordingStateCallbackUrl("<recordingStateCallbackUrl>");

Response<RecordingStateResult> response = callAutomationClient.getCallRecording()
.startWithResponse(recordingOptions, null);

// Pause recording using recordingId received in response of start recording
Response<Void> response = callAutomationClient.getCallRecording()
              .pauseWithResponse(recordingId, null);

// Resume recording using recordingId received in response of start recording
Response<Void> response = callAutomationClient.getCallRecording()
               .resumeWithResponse(recordingId, null);

// Stop recording using recordingId received in response of start recording
Response<Void> response = callAutomationClient.getCallRecording()
               .stopWithResponse(recordingId, null);

JavaScript

// Start recording
var locator: CallLocator = { id: "<ServerCallId>", kind: "serverCallLocator" };

var options: StartRecordingOptions =
{
  callLocator: locator,
  recordingContent: "audio",
  recordingChannel:"unmixed",
  recordingFormat: "wav",
  recordingStateCallbackEndpointUrl: "<CallbackUri>"
};
var response = await callAutomationClient.getCallRecording().start(options);

// Pause recording using recordingId received in response of start recording
var pauseRecording = await callAutomationClient.getCallRecording().pause(recordingId);

// Resume recording using recordingId received in response of start recording.
var resumeRecording = await callAutomationClient.getCallRecording().resume(recordingId);

// Stop recording using recordingId received in response of start recording
var stopRecording = await callAutomationClient.getCallRecording().stop(recordingId);

Python

# Start recording
response = call_automation_client.start_recording(call_locator=ServerCallLocator(server_call_id),
            recording_content_type = RecordingContent.Audio,
            recording_channel_type = RecordingChannel.Unmixed,
            recording_format_type = RecordingFormat.Wav,
            recording_state_callback_url = "<CallbackUri>")

# Pause recording using recording_id received in response of start recording
pause_recording = call_automation_client.pause_recording(recording_id = recording_id)

# Resume recording using recording_id received in response of start recording
resume_recording = call_automation_client.resume_recording(recording_id = recording_id)

# Stop recording using recording_id received in response of start recording
stop_recording = call_automation_client.stop_recording(recording_id = recording_id)

Ukončení hovoru

K ukončení volání můžete použít akci Zavěsit sadu SDK pro automatizaci volání. Po dokončení akce zavěsit sdk publikuje CallDisconnected událost.

csharp

_ = await client.GetCallConnection(callConnectionId).HangUpAsync(forEveryone: true); 

Java

Response<Void> response = client.getCallConnectionAsync(callConnectionId).hangUpWithResponse(true).block();

JavaScript

await callConnection.hangUp(true);

Python

call_connection_client = call_automation_client.get_call_connection(
    "call_connection_id"
)

call_connection_client.hang_up(is_for_everyone=True)

Další akce

Při volání do místnosti se podporují také následující akce v hovoru v hovoru.

1. Přidání účastníka (identifikátor služby ACS)
2. Odebrání účastníka (identifikátor služby ACS)
3. Zrušení přidání účastníka (identifikátor ACS a číslo veřejné telefonní sítě)
4. Zavěsit hovor
5. Získání účastníka (identifikátor služby ACS a číslo veřejné telefonní sítě)
6. Získání více účastníků (identifikátor služby ACS a číslo veřejné telefonní sítě)
7. Získání nejnovějších informací o hovoru
8. Přehrávání zvukových souborů i textu
9. Přehrání všech zvukových souborů i textu
10. Rozpoznávání DTMF i řeči
11. Rozpoznávání průběžného DTMF

Další informace najdete v tématu Akce volání a akce médií.

Další kroky

V této části jste se naučili:

• Připojení k volání místnosti z aplikace
• Přidání akcí volání do volání do místnosti pomocí volání sad SDK
• Přidání akcí volání do volání místnosti pomocí sad SDK pro automatizaci volání

Můžete také chtít:

• Další informace o konceptech místností
• Informace o funkcích volání sad SDK
• Další informace o konceptech automatizace volání