Merge pull request #278092 from leejyoon/main

Native Teams Meeting ID and Passcode quickstart

Author: v-dirichards

articles/communication-services/quickstarts/voice-video-calling/includes/teams-interop/teams-interop-android.md

@@ -17,6 +17,7 @@ Find the finalized code for this quickstart on [GitHub](https://github.com/Azure
 
 - A working [Communication Services calling Android app](../../getting-started-with-calling.md).
 - A [Teams deployment](/deployoffice/teams-install).
+- The Minimum Version supported for Teams meeting ID and passcode join API: 2.9.0
 - An [access token](../../../identity/access-tokens.md).
 
 
@@ -32,19 +33,46 @@ Replace code in activity_main.xml with following snippet. The text box will be u
     android:layout_width="match_parent"
     android:layout_height="match_parent"
     tools:context=".MainActivity">
-
-    <EditText
-        android:id="@+id/teams_meeting_link"
-        android:layout_width="match_parent"
-        android:layout_height="wrap_content"
-        android:ems="10"
-        android:hint="Teams meeting link"
-        android:inputType="textUri"
-        android:layout_marginTop="100dp"
-        android:layout_marginHorizontal="20dp"
-        app:layout_constraintEnd_toEndOf="parent"
-        app:layout_constraintStart_toStartOf="parent"
-        app:layout_constraintTop_toTopOf="parent" />
+    
+    <LinearLayout    
+    android:id="@+id/meetingInfoLinearLayout"    
+    android:layout_width="match_parent"    
+    android:layout_height="match_parent"    
+    android:orientation="vertical"    
+    android:layout_marginTop="100dp">
+
+        <EditText    
+            android:id="@+id/teams_meeting_link"    
+            android:layout_width="match_parent"    
+            android:layout_height="wrap_content"    
+            android:ems="10"    
+            android:hint="Teams meeting link"    
+            android:inputType="textUri" />
+            
+        <TextView    
+            android:layout_width="match_parent"    
+            android:layout_height="wrap_content"    
+            android:text="or"    
+            android:textAlignment="center"    
+            android:layout_marginTop="10dp"/>
+            
+        <EditText    
+            android:id="@+id/teams_meeting_id"    
+            android:layout_width="match_parent"    
+            android:layout_height="wrap_content"    
+            android:ems="10"    
+            android:hint="Teams meeting id"    
+            android:inputType="textUri" />
+        
+        <EditText    
+            android:id="@+id/teams_meeting_passcode"    
+            android:layout_width="match_parent"    
+            android:layout_height="wrap_content"    
+            android:ems="10"    
+            android:hint="Teams meeting passcode"    
+            android:inputType="textUri" />
+        
+    </LinearLayout>
 
     <LinearLayout
         android:layout_width="match_parent"
@@ -120,6 +148,8 @@ import com.azure.android.communication.calling.HangUpOptions;
 import com.azure.android.communication.calling.JoinCallOptions;
 import com.azure.android.communication.common.CommunicationTokenCredential;
 import com.azure.android.communication.calling.TeamsMeetingLinkLocator;
+// import for meeting id and passcode join
+// import com.azure.android.communication.calling.TeamsMeetingIdLocator;
 
 public class MainActivity extends AppCompatActivity {
     private static final String[] allPermissions = new String[] { Manifest.permission.RECORD_AUDIO, Manifest.permission.CAMERA, Manifest.permission.WRITE_EXTERNAL_STORAGE, Manifest.permission.READ_PHONE_STATE };
@@ -159,17 +189,28 @@ public class MainActivity extends AppCompatActivity {
         }
 
         EditText calleeIdView = findViewById(R.id.teams_meeting_link);
+        EditText calleeMeetingId = findViewById(R.id.teams_meeting_id);
+        EditText calleeMeetingPasscode = findViewById(R.id.teams_meeting_passcode);
         String meetingLink = calleeIdView.getText().toString();
+        String meetingId = calleeMeetingId.getText().toString();
+        String passcode = calleeMeetingPasscode.getText().toString();
+
         if (meetingLink.isEmpty()) {
             Toast.makeText(this, "Please enter Teams meeting link", Toast.LENGTH_SHORT).show();
             return;
         }
 
         JoinCallOptions options = new JoinCallOptions();
-        TeamsMeetingLinkLocator teamsMeetingLinkLocator = new TeamsMeetingLinkLocator(meetingLink);
+
+        // join with meeting link
+        TeamsMeetingLinkLocator teamsMeetingLocator = new TeamsMeetingLinkLocator(meetingLink);
+
+        // (or) to join with meetingId and passcode use the below code snippet.
+        //TeamsMeetingIdLocator teamsMeetingIdLocator = new TeamsMeetingIdLocator(meetingId, passcode);
+
         call = agent.join(
                 getApplicationContext(),
-                teamsMeetingLinkLocator,
+                teamsMeetingLocator,
                 options);
         call.addOnStateChangedListener(p -> setCallStatus(call.getState().toString()));
         call.addOnIsRecordingActiveChangedListener(p -> setRecordingStatus(call.isRecordingActive()));
@@ -255,6 +296,11 @@ public class MainActivity extends AppCompatActivity {
 The Teams meeting link can be retrieved using Graph APIs. This is detailed in [Graph documentation](/graph/api/onlinemeeting-createorget?tabs=http&view=graph-rest-beta&preserve-view=true).
 The Communication Services Calling SDK accepts a full Teams meeting link. This link is returned as part of the `onlineMeeting` resource, accessible under the [`joinWebUrl` property](/graph/api/resources/onlinemeeting?view=graph-rest-beta&preserve-view=true). You can also get the required meeting information from the **Join Meeting** URL in the Teams meeting invite itself.
 
+## Get the Teams meeting ID and passcode
+* Graph API: Use Graph API to retrieve information about onlineMeeting resource and check the object in property joinMeetingIdSettings.
+* Teams: In your Teams application, go to Calendar app and open details of a meeting. Online meetings have meeting ID and passcode in the definition of the meeting.
+* Outlook: You can find the meeting ID & passcode in calendar events or in email meeting invites.
+
 ## Launch the app and join Teams meeting
 
 The app can now be launched using the "Run App" button on the toolbar (Shift+F10). You should see the following:

articles/communication-services/quickstarts/voice-video-calling/includes/teams-interop/teams-interop-ios.md

@@ -44,6 +44,8 @@ import AVFoundation
 
 struct ContentView: View {
     @State var meetingLink: String = ""
+    @State var meetingId: String = ""
+    @State var meetingPasscode: String = ""
     @State var callStatus: String = ""
     @State var message: String = ""
     @State var recordingStatus: String = ""
@@ -57,6 +59,8 @@ struct ContentView: View {
             Form {
                 Section {
                     TextField("Teams meeting link", text: $meetingLink)
+                    TextField("Teams meeting id", text: $meetingId)
+                    TextField("Teams meeting passcode", text: $meetingPasscode)
                     Button(action: joinTeamsMeeting) {
                         Text("Join Teams Meeting")
                     }.disabled(callAgent == nil)
@@ -100,8 +104,14 @@ struct ContentView: View {
         AVAudioSession.sharedInstance().requestRecordPermission { (granted) in
             if granted {
                 let joinCallOptions = JoinCallOptions()
-                let teamsMeetingLinkLocator = TeamsMeetingLinkLocator(meetingLink: self.meetingLink)
-                self.callAgent?.join(with: teamsMeetingLinkLocator, joinCallOptions: joinCallOptions) {(call, error) in
+
+                // join with meeting link
+                let teamsMeetingLocator = TeamsMeetingLinkLocator(meetingLink: self.meetingLink)
+
+                // (or) to join with meetingId and passcode use the below code snippet.
+                // let teamsMeetingLocator = TeamsMeetingIdLocator(with: self.meetingId, passcode: self.meetingPasscode)
+
+                self.callAgent?.join(with: teamsMeetingLocator, joinCallOptions: joinCallOptions) {(call, error) in
                     if (error == nil) {
                         self.call = call
                         self.callObserver = CallObserver(self)

articles/communication-services/quickstarts/voice-video-calling/includes/teams-interop/teams-interop-windows.md

@@ -10,10 +10,14 @@ ms.service: azure-communication-services
 
 In this quickstart, you'll learn how to join a Teams meeting using the Azure Communication Services Calling SDK for Windows.
 
+## Sample Code
+Find the finalized code for this quickstart on GitHub for [UWP](https://github.com/Azure-Samples/communication-services-dotnet-quickstarts/tree/main/Calling) and [WinUI 3](https://github.com/Azure-Samples/communication-services-dotnet-quickstarts/tree/main/CallingWinUI).
+
 ## Prerequisites
 
 - A working [Communication Services calling Windows app](../../getting-started-with-calling.md).
 - A [Teams deployment](/deployoffice/teams-install).
+- The Minimum Version supported for Teams meeting ID and passcode join API: 1.7.0
 - An [access token](../../../identity/access-tokens.md).
 
 ## Add the Teams UI controls and Enable the Teams UI controls
@@ -39,14 +43,20 @@ Replace code in MainPage.xaml with following snippet. The text box will be used
             <RowDefinition Height="60*"/>
             <RowDefinition Height="16*"/>
         </Grid.RowDefinitions>
-        <TextBox Grid.Row="1" x:Name="CalleeTextBox" PlaceholderText="Who would you like to call?" TextWrapping="Wrap" VerticalAlignment="Center" Height="30" Margin="10,10,10,10" />
 
-        <Grid x:Name="AppTitleBar" Background="LightSeaGreen">
+        <Grid Grid.Row="0" x:Name="AppTitleBar" Background="LightSeaGreen">
             <!-- Width of the padding columns is set in LayoutMetricsChanged handler. -->
             <!-- Using padding columns instead of Margin ensures that the background paints the area under the caption control buttons (for transparent buttons). -->
             <TextBlock x:Name="QuickstartTitle" Text="Calling Quickstart sample title bar" Style="{StaticResource CaptionTextBlockStyle}" Padding="7,7,0,0"/>
         </Grid>
 
+        <StackPanel Grid.Row="1">
+            <TextBox x:Name="CalleeTextBox" PlaceholderText="Who would you like to call?" TextWrapping="Wrap" VerticalAlignment="Center" />
+            <TextBlock Text="or" Padding="7,7,0,0" />
+            <TextBox x:Name="CalleeMeetingId" PlaceholderText="Teams Meeting Id" TextWrapping="Wrap" VerticalAlignment="Center" />
+            <TextBox x:Name="CalleeMeetingPasscode" PlaceholderText="Teams Meeting Passcode" TextWrapping="Wrap" VerticalAlignment="Center" />
+        </StackPanel>
+
         <Grid Grid.Row="2">
             <Grid.RowDefinitions>
                 <RowDefinition/>
@@ -121,12 +131,18 @@ namespace CallingQuickstart
         private async void CallButton_Click(object sender, RoutedEventArgs e)
         {
             var callString = CalleeTextBox.Text.Trim();
+            var meetingId = CalleeMeetingId.Text.Trim();
+            var passcode = CalleeMeetingPasscode.Text.Trim();
 
+            // join with meeting link
             if (!string.IsNullOrEmpty(callString))
             {
                 call = await JoinTeamsMeetingByLinkAsync(teamsMeetinglink);
             }
 
+            // (or) to join with meetingId and passcode use the below code snippet.
+            // call = await JoinTeamsMeetingByMeetingIdAsync(meetingId, passcode);
+
             if (call != null)
             {
                 call.RemoteParticipantsUpdated += OnRemoteParticipantsUpdatedAsync;
@@ -333,6 +349,15 @@ namespace CallingQuickstart
             return call;
         }
 
+        private async Task<CommunicationCall> JoinTeamsMeetingByMeetingIdAsync(String meetingId, String passcode)
+        {
+            var joinCallOptions = GetJoinCallOptions();
+
+            var teamsMeetingIdLocator = new TeamsMeetingIdLocator(meetingId, passcode);
+            var call = await callAgent.JoinAsync(teamsMeetingIdLocator, joinCallOptions);
+            return call;
+        }
+
         private JoinCallOptions GetJoinCallOptions()
         {
             return new JoinCallOptions() {
@@ -351,6 +376,11 @@ namespace CallingQuickstart
 The Teams meeting link can be retrieved using Graph APIs. This is detailed in [Graph documentation](/graph/api/onlinemeeting-createorget?tabs=http&view=graph-rest-beta&preserve-view=true).
 The Communication Services Calling SDK accepts a full Teams meeting link. This link is returned as part of the `onlineMeeting` resource, accessible under the [`joinWebUrl` property](/graph/api/resources/onlinemeeting?view=graph-rest-beta&preserve-view=true). You can also get the required meeting information from the **Join Meeting** URL in the Teams meeting invite itself.
 
+## Get the Teams meeting ID and passcode
+* Graph API: Use Graph API to retrieve information about onlineMeeting resource and check the object in property `joinMeetingIdSettings`.
+* Teams: In your Teams application, go to Calendar app and open details of a meeting. Online meetings have meeting ID and passcode in the definition of the meeting.
+* Outlook: You can find the meeting ID & passcode in calendar events or in email meeting invites.
+
 ## Launch the app and join Teams meeting
 
 You can build and run your app on Visual Studio by selecting **Debug** > **Start Debugging** or by using the (F5) keyboard shortcut.