Szybki start: zarządzanie połączeniem pokoju

Wprowadzenie

Podczas wywołania pokoju usług Azure Communication Services (ACS) można zarządzać wywołaniem przy użyciu zestawów SDK wywoływania lub zestawów SDK usługi Call Automation albo obu tych zestawów. W wywołaniu pokoju można kontrolować akcje wywołania przy użyciu obu ról przypisanych do uczestników i właściwości skonfigurowanych w pomieszczeniu. Role uczestnika kontrolują możliwości dozwolone dla każdego uczestnika, podczas gdy właściwości pokoju mają zastosowanie do połączenia pokoju jako całości.

Wywoływanie zestawów SDK

Zestaw SDK wywołujący po stronie klienta to biblioteka wywołująca klienta, która umożliwia uczestnikom wywołania pokoju wykonywanie kilku operacji w wywołaniu, takich jak udostępnianie ekranu, włączanie/wyłączanie wideo, wyciszanie/wyłączanie i tak dalej. Aby uzyskać pełną listę możliwości, zobacz Wywoływanie zestawu SDK — omówienie.

Możesz kontrolować możliwości na podstawie ról przypisanych do uczestników wywołania. Na przykład tylko prezenter może udostępniać ekran. Aby uzyskać informacje o rolach i uprawnieniach uczestników, zobacz Pojęcia dotyczące pokoi.

Zestawy SDK automatyzacji wywołań

Zestaw SDK usługi Call Automation to biblioteka po stronie serwera, która umożliwia administratorom zarządzanie trwającym wywołaniem pokoju w centralnym i kontrolowanym środowisku. W przeciwieństwie do zestawu SDK wywoływania operacje zestawu SDK usługi Call Automation są niezależne od ról. W związku z tym administrator połączeń może wykonywać kilka operacji w wywołaniu w imieniu uczestników rozmów pokojowych.

Na poniższej liście opisano typowe akcje w wywołaniu pokoju dostępne w wywołaniu pokoju.

Nawiązywanie połączenia z pokojem

Usługa Call Automation musi nawiązać połączenie z istniejącym wywołaniem pokoju przed wykonaniem dowolnych operacji wywołania. Zdarzenia CallConnected lub ConnectFailed są wywoływane przy użyciu mechanizmów wywołania zwrotnego, aby wskazać, czy operacja połączenia zakończyła się pomyślnie, czy zakończyła się niepowodzeniem.

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 pomyślnym nawiązaniu połączenia z pokojem CallConnect zdarzenie jest powiadamiane za pośrednictwem identyfikatora URI wywołania zwrotnego. Możesz użyć callConnectionId polecenia , aby pobrać połączenie połączenia z pokojem zgodnie z potrzebami. Poniższe przykładowe fragmenty kodu używają elementu , callConnectionId aby zademonstrować tę funkcję.

Dodawanie uczestnika PSTN

Za pomocą usługi Call Automation możesz wybrać numer PSTN i dodać uczestnika do połączenia pokoju. Należy jednak skonfigurować pomieszczenie, aby włączyć opcję wybierania numerów PSTN (EnabledPSTNDialout ustawioną na truewartość ), a zasób usług Azure Communication Services musi mieć prawidłowy numer telefonu.

Aby uzyskać więcej informacji, zobacz Przewodnik Szybki start dotyczący pokoi.

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>"
)

Usuwanie uczestnika PSTN

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>")

Wyślij DTMF

Wyślij listę tonów DTMF do uczestnika zewnętrznego.

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")

Nagrywanie połączeń

Pokoje usług Azure Communication Services obsługują funkcje rejestrowania, w tym start, stop, pause, resumei tak dalej, udostępniane przez usługę Call Automation. Zobacz następujące fragmenty kodu, aby uruchomić/zatrzymać/wstrzymać/wznowić nagrywanie w wywołaniu pokoju. Aby uzyskać pełną listę akcji, zobacz Rejestrowanie wywołań automatyzacji.

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)

Kończenie połączenia

Możesz użyć akcji Zawieszanie się zestawu SDK usługi Call Automation, aby zakończyć wywołanie. Po zakończeniu akcji Zawieszanie się zestaw SDK publikuje CallDisconnected zdarzenie.

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)

Inne akcje

Następujące akcje in-call są również obsługiwane w wywołaniu pokoju.

1. Dodawanie uczestnika (identyfikator ACS)
2. Usuń uczestnika (identyfikator ACS)
3. Anulowanie dodawania uczestnika (identyfikator ACS i numer PSTN)
4. Zawieszanie połączenia
5. Pobieranie uczestnika (identyfikator ACS i numer PSTN)
6. Pobieranie wielu uczestników (identyfikator ACS i numer PSTN)
7. Uzyskiwanie najnowszych informacji o połączeniu
8. Odtwarzanie zarówno plików audio, jak i tekstu
9. Odtwórz wszystkie pliki audio i tekst
10. Rozpoznawanie zarówno dtMF, jak i mowy
11. Rozpoznawanie ciągłego jednostki DTMF

Aby uzyskać więcej informacji, zobacz akcje wywołania i akcje multimedialne.

Następne kroki

W tej sekcji przedstawiono, jak wykonać następujące działania:

• Dołączanie połączenia pokoju z aplikacji
• Dodawanie akcji wywołania do wywołania pokoju przy użyciu zestawów SDK wywołujących
• Dodawanie akcji wywołania do wywołania pokoju przy użyciu zestawów SDK usługi Call Automation

Możesz również wykonać następujące czynności:

• Dowiedz się więcej o pojęciach dotyczących pokoi
• Dowiedz się więcej o wywoływaniu funkcji zestawów SDK
• Dowiedz się więcej o pojęciach związanych z automatyzacją wywołań