GraphCallingBots 1.0.0
dotnet add package GraphCallingBots --version 1.0.0
NuGet\Install-Package GraphCallingBots -Version 1.0.0
<PackageReference Include="GraphCallingBots" Version="1.0.0" />
paket add GraphCallingBots --version 1.0.0
#r "nuget: GraphCallingBots, 1.0.0"
// Install GraphCallingBots as a Cake Addin #addin nuget:?package=GraphCallingBots&version=1.0.0 // Install GraphCallingBots as a Cake Tool #tool nuget:?package=GraphCallingBots&version=1.0.0
Teams Calling Bots (with optional PSTN)
Graph calling bots built for ASP.Net 8. Simplify calling bots for Teams/Graph in C#; designed for scalable cloud.
This is a project to demonstrate how calling bots can work in Teams, using service-hosted media (static WAV files only). It doesn’t use the Graph Communications Calling SDK except for some model classes and request validation checks, as I wanted a more .Net standardised app model: abstracted state persistence, standard logging libraries etc, that fit much better into things like functions apps where you don’t necessarily keep everything in memory (stateful).
The calling logic therefore is much simplified and just uses standard .Net classes and libraries, which makes it more lightweight, but does means it can’t handle app-hosted media for now.
How do Bots Work in this Framework?
Here's an example:
public class CallInviteBot : AudioPlaybackAndDTMFCallingBot<GroupCallInviteActiveCallState>
{
public const string TRANSFERING_PROMPT_ID = "transferingPrompt";
/// <summary>
/// Call someone and ask if they can join a group call.
/// </summary>
public async Task<Call?> InviteUserToGroupCall(AttendeeCallInfo initialAdd, StartGroupCallData groupMeetingRequest, Call createdGroupCall)
{
var callMediaPlayList = new List<MediaInfo>
{
// Add default media prompt. Will automatically play when call is connected.
new MediaInfo { Uri = groupMeetingRequest.MessageInviteUrl, ResourceId = DEFAULT_PROMPT_ID },
// Add any message transfering audio
new MediaInfo { Uri = groupMeetingRequest.MessageTransferingUrl, ResourceId = TRANSFERING_PROMPT_ID }
};
// Start P2P call
var singleAttendeeCallReq = await CreateCallRequest(new InvitationParticipantInfo { Identity = initialAdd.ToIdentity() }, callMediaPlayList, groupMeetingRequest.HasPSTN, false);
var singleAttendeeCall = await CreateNewCall(singleAttendeeCallReq);
// Remember initial state of the call: which group-call to transfer to and who to transfer
await InitCallStateAndStoreMediaInfoForCreatedCall(singleAttendeeCall, callMediaPlayList,
createdCallState =>
{
createdCallState.GroupCallId = createdGroupCall.Id;
createdCallState.AtendeeIdentity = initialAdd.ToIdentity();
});
return singleAttendeeCall;
}
protected async override Task NewTonePressed(GroupCallInviteActiveCallState callState, Tone tone)
{
if (tone == Tone.Tone1)
{
// Play "transfering" WAV.
await PlayConfiguredMediaIfNotAlreadyPlaying(callState, TRANSFERING_PROMPT_ID);
// Transfer P2P call to group call, replacing the call used for the invite
var transferReq = new InvitePostRequestBody
{
Participants = new List<InvitationParticipantInfo>
{
new InvitationParticipantInfo
{
Identity = callState.AtendeeIdentity,
ReplacesCallId = callState.CallId
},
},
};
await _graphServiceClient.Communications.Calls[callState.GroupCallId].Participants.Invite.PostAsync(transferReq);
}
}
}
See more on the repo home - GitHub link
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
-
net8.0
- Azure.Data.Tables (>= 12.8.3)
- Microsoft.Azure.Cosmos (>= 3.41.0)
- Microsoft.EntityFrameworkCore (>= 8.0.7)
- Microsoft.EntityFrameworkCore.SqlServer (>= 8.0.7)
- Microsoft.Extensions.Logging.Abstractions (>= 8.0.1)
- Microsoft.Graph.Communications.Core (>= 1.2.0.10563)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
1.0.0 | 117 | 7/12/2024 |
First release. Has been used in various production scenarios already.