Doc updates, renamed a function

Author: sharadb-amazon

examples/tv-casting-app/APIs.md

@@ -71,10 +71,11 @@ In order to illustrate these steps, refer to the figure below
 The Casting Client is expected to consume the Matter TV Casting library built
 for its respective platform which implements the APIs described in this
 document. Refer to the tv-casting-app READMEs for [Linux](linux/README.md),
-Android and [iOS](darwin/TvCasting/README.md) to understand how to build and
-consume each platform's specific libraries. The libraries MUST be built with the
-client's specific values for `CHIP_DEVICE_CONFIG_DEVICE_VENDOR_ID` and
-`CHIP_DEVICE_CONFIG_DEVICE_PRODUCT_ID` updated in the
+[Android](android/README.md) and [iOS](darwin/TvCasting/README.md) to understand
+how to build and consume each platform's specific libraries. The libraries MUST
+be built with the client's specific values for
+`CHIP_DEVICE_CONFIG_DEVICE_VENDOR_ID` and `CHIP_DEVICE_CONFIG_DEVICE_PRODUCT_ID`
+updated in the
 [CHIPProjectAppConfig.h](tv-casting-common/include/CHIPProjectAppConfig.h) file.
 Other values like the `CHIP_DEVICE_CONFIG_DEVICE_NAME` may be updated as well to
 correspond to the client being built.
@@ -688,7 +689,7 @@ func startDiscovery() {
 }
 ```
 
-Note: You will need to connect with a Casting Player as described below to see
+Note: You will need to connect with a Casting Player as described below to se
 the list of Endpoints that they support. Refer to the
 [Connection](#connect-to-a-casting-player) section for details on how to
 discover available endpoints supported by a Casting Player.
@@ -864,7 +865,7 @@ On Android, it can select an `Endpoint` as shown below.
 ```java
 private static final Integer SAMPLE_ENDPOINT_VID = 65521;
 
-private Endpoint selectEndpoint()
+private Endpoint selectFirstEndpointByVID()
 {
     Endpoint endpoint = null;
     if(selectedCastingPlayer != null)

examples/tv-casting-app/android/App/app/src/main/java/com/chip/casting/util/GlobalCastingConstants.java

@@ -6,5 +6,6 @@ public class GlobalCastingConstants {
   public static final int SetupPasscode = 20202021;
   public static final int Discriminator = 0xF00;
   public static final boolean ChipCastingSimplified =
-      true; // set this flag to true to demo simplified casting APIs
+      true; // set to true, to demo the simplified casting APIs. Otherwise, the older deprecated
+  // APIs are invoked
 }

examples/tv-casting-app/android/App/app/src/main/java/com/matter/casting/ApplicationBasicReadVendorIDExampleFragment.java

@@ -68,7 +68,8 @@ public View onCreateView(
       LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
     this.readButtonClickListener =
         v -> {
-          Endpoint endpoint = EndpointSelectorExample.selectEndpointByVID(selectedCastingPlayer);
+          Endpoint endpoint =
+              EndpointSelectorExample.selectFirstEndpointByVID(selectedCastingPlayer);
           if (endpoint == null) {
             Log.e(TAG, "No Endpoint with sample vendorID found on CastingPlayer");
             return;

examples/tv-casting-app/android/App/app/src/main/java/com/matter/casting/ContentLauncherLaunchURLExampleFragment.java

@@ -68,7 +68,8 @@ public View onCreateView(
       LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
     this.launchUrlButtonClickListener =
         v -> {
-          Endpoint endpoint = EndpointSelectorExample.selectEndpointByVID(selectedCastingPlayer);
+          Endpoint endpoint =
+              EndpointSelectorExample.selectFirstEndpointByVID(selectedCastingPlayer);
           if (endpoint == null) {
             Log.e(TAG, "No Endpoint with sample vendorID found on CastingPlayer");
             return;

examples/tv-casting-app/android/App/app/src/main/java/com/matter/casting/EndpointSelectorExample.java

@@ -10,7 +10,11 @@ public class EndpointSelectorExample {
   private static final String TAG = EndpointSelectorExample.class.getSimpleName();
   private static final Integer SAMPLE_ENDPOINT_VID = 65521;
 
-  public static Endpoint selectEndpointByVID(CastingPlayer selectedCastingPlayer) {
+  /**
+   * Returns the first Endpoint in the list of Endpoints associated with the selectedCastingPlayer
+   * whose VendorID matches the EndpointSelectorExample.SAMPLE_ENDPOINT_VID
+   */
+  public static Endpoint selectFirstEndpointByVID(CastingPlayer selectedCastingPlayer) {
     Endpoint endpoint = null;
     if (selectedCastingPlayer != null) {
       List<Endpoint> endpoints = selectedCastingPlayer.getEndpoints();

examples/tv-casting-app/android/App/app/src/main/java/com/matter/casting/MediaPlaybackSubscribeToCurrentStateExampleFragment.java

@@ -70,7 +70,7 @@ public void onCreate(Bundle savedInstanceState) {
   @Override
   public View onCreateView(
       LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
-    Endpoint endpoint = EndpointSelectorExample.selectEndpointByVID(selectedCastingPlayer);
+    Endpoint endpoint = EndpointSelectorExample.selectFirstEndpointByVID(selectedCastingPlayer);
     if (endpoint == null) {
       Log.e(TAG, "No Endpoint with sample vendorID found on CastingPlayer");
       return inflater.inflate(

examples/tv-casting-app/android/README.md

@@ -70,6 +70,18 @@ Complete the following steps to prepare the Matter build:
     source scripts/bootstrap.sh
     ```
 
+3. The build will produce libraries: AndroidPlatform.jar, CHIPAppServer.jar,
+   CHIPInteractionModel.jar and TVCastingApp.jar in [App/app/libs](App/app/libs)
+   and libTvCastingApp.so and libc++\_shared.so in
+   [App/app/libs/jniLibs/](App/app/libs/jniLibs/) consumed by any casting app to
+   leverage the [casting APIs](../APIs.md), like the sample android
+   tv-casting-app. If building for your own casting app, make sure your client's
+   specific values are set for `CHIP_DEVICE_CONFIG_DEVICE_VENDOR_ID` and
+   `CHIP_DEVICE_CONFIG_DEVICE_PRODUCT_ID` in the
+   [CHIPProjectAppConfig.h](tv-casting-common/include/CHIPProjectAppConfig.h)
+   file, before the build. Other values like the
+   `CHIP_DEVICE_CONFIG_DEVICE_NAME` may be optionally updated as well.
+
 ## Building & Installing the app
 
 This is the simplest option. In the command line, run the following command from