iOS tv-casting-app: Apply StackLocks and sequence callbacks (#26817)

* V1.0.0 branch 25023 fix (#110)

* Lock the SDK before interacting with it.

[Problem]

The Matter SDK assumes that the client will take a lock on the SDK prior to
interacting with any APIs. There is 1 Android function and several iOS functions
that do not take the lock prior to interacting with the SDK APIs.

There are also some functions that invoke the Matter SDK in a way that may
result in out-of-order callback invocation (e.g. the conceptual "started"
callback may be invoked after the conceptual "ended" callback).

[Solution]

Create utility functions that help ensure that the Matter SDK is invoked safely
and that callbacks are delivered in the correct order.

[Testing]

Performed local, manual testing with the 'tv-casting-app' example on iOS against
a Raspberry Pi running the 'tv-app'. Ran the certification test in the
'tv-casting-app' on iOS against the same Raspberry Pi.

* * Updating naming and parameter order for new CastingServerBridge APIs
* Refactored the Certification Tests to more fully exercise threading behavior

* * Updating the documentation for modified APIs

* Restyling

---------

Co-authored-by: Michael Douglas <125094815+domichae-amazon@users.noreply.github.com>

examples/tv-casting-app/darwin/MatterTvCastingBridge/MatterTvCastingBridge/CastingServerBridge.h

@@ -1,6 +1,6 @@
 /**
  *
- * Copyright (c) 2020-2022 Project CHIP Authors
+ * Copyright (c) 2020-2023 Project CHIP Authors
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -102,7 +102,7 @@
 
  @return Onboarding payload
  */
-- (OnboardingPayload * _Nonnull)getOnboardingPaylod;
+- (OnboardingPayload * _Nonnull)getOnboardingPayload;
 
 /*!
  @brief Request opening of a basic commissioning window

examples/tv-casting-app/darwin/MatterTvCastingBridge/MatterTvCastingBridge/CommissionerDiscoveryDelegateImpl.h

@@ -26,7 +26,7 @@ class CommissionerDiscoveryDelegateImpl : public chip::Controller::DeviceDiscove
 public:
  void SetUp(dispatch_queue_t _Nonnull clientQueue,
  void (^_Nonnull objCDiscoveredCommissionerHandler)(DiscoveredNodeData * _Nonnull),
- TargetVideoPlayerInfo * cachedTargetVideoPlayerInfos)
+ TargetVideoPlayerInfo * _Nullable cachedTargetVideoPlayerInfos)
  {
  mClientQueue = clientQueue;
  mObjCDiscoveredCommissionerHandler = objCDiscoveredCommissionerHandler;
@@ -59,7 +59,7 @@ class CommissionerDiscoveryDelegateImpl : public chip::Controller::DeviceDiscove
 private:
  void (^_Nonnull mObjCDiscoveredCommissionerHandler)(DiscoveredNodeData * _Nonnull);
  dispatch_queue_t _Nonnull mClientQueue;
- TargetVideoPlayerInfo * mCachedTargetVideoPlayerInfos;
+ TargetVideoPlayerInfo * _Nullable mCachedTargetVideoPlayerInfos;
 };
 
 #endif /* CommissionerDiscoveryDelegateImpl_h */

examples/tv-casting-app/darwin/TvCasting/TvCasting/CertTestView.swift

@@ -1,7 +1,7 @@
 
 /**
  *
- * Copyright (c) 2020-2022 Project CHIP Authors
+ * Copyright (c) 2020-2023 Project CHIP Authors
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -21,6 +21,7 @@ import SwiftUI
 struct CertTestView: View {
  @StateObject var viewModel = CertTestViewModel()
  @State private var targetContentAppId: String = ""
+ @State private var parallelizeTests = true
 
  var body: some View {
  VStack(alignment: .leading) {
@@ -46,9 +47,17 @@ struct CertTestView: View {
  }
  .border(.secondary)
  }
+ HStack() {
+ Toggle(isOn: $parallelizeTests) {
+ Text("Parallelize Tests")
+ }
+ }
 
  Button("Launch Test") {
- viewModel.launchTest(targetContentAppId: targetContentAppId)
+ viewModel.launchTests(
+ targetContentAppId: targetContentAppId,
+ inParallel: parallelizeTests
+ )
  }
  .background(Color.blue)
  .foregroundColor(Color.white)