diff --git a/docs/how-to/client/ios-simulator-camera.mdx b/docs/how-to/client/ios-simulator-camera.mdx new file mode 100644 index 00000000..8c803bb8 --- /dev/null +++ b/docs/how-to/client/ios-simulator-camera.mdx @@ -0,0 +1,23 @@ +--- +sidebar_position: 17 +sidebar_label: "iOS Simulator Camera 📱" +description: Use SimCam to test camera features in the iOS Simulator without a physical device. +--- + +# iOS Simulator Camera Mobile + +The iOS Simulator has no camera, which means you normally need a physical device to test video streaming with Fishjam. + +[SimCam](https://simcam.swmansion.com/) is a macOS app that injects a virtual camera into the simulator. It works through standard AVFoundation APIs, so `@fishjam-cloud/react-native-client` picks it up without any changes to your code. + +## What SimCam provides + +- **Live camera feed**: your Mac's camera streamed into the simulator +- **Video file**: a video clip you can replay for consistent test scenarios +- **QR code**: inject QR codes without holding a phone up to the screen + +## Getting started + +1. Download and install SimCam from [simcam.swmansion.com](https://simcam.swmansion.com/). +2. Launch SimCam and pick a camera source. +3. Run your app in the simulator. The virtual camera shows up just like a real one. diff --git a/docs/how-to/client/managing-devices.mdx b/docs/how-to/client/managing-devices.mdx index 063b1f8d..1572a086 100644 --- a/docs/how-to/client/managing-devices.mdx +++ b/docs/how-to/client/managing-devices.mdx @@ -77,6 +77,10 @@ export function FlipButton() { +:::tip[Testing on iOS Simulator] +The iOS Simulator has no camera. [SimCam](https://simcam.swmansion.com/) solves this by injecting a virtual feed (your Mac's camera or a video file), so you can test without a physical device. See [Camera on iOS Simulator](./ios-simulator-camera). +::: + ## Turning Camera On and Off diff --git a/docs/tutorials/react-native-quick-start.mdx b/docs/tutorials/react-native-quick-start.mdx index addf5d57..6aa7be57 100644 --- a/docs/tutorials/react-native-quick-start.mdx +++ b/docs/tutorials/react-native-quick-start.mdx @@ -164,7 +164,7 @@ export default function Root() { ``` :::important -This won't work on the iOS Simulator, as the Simulator can't access the camera. Test on a real device. +The iOS Simulator has no camera. To test camera features, use a real device or [SimCam](https://simcam.swmansion.com/), which injects a virtual camera the simulator picks up automatically. See [Camera on iOS Simulator](../how-to/client/ios-simulator-camera). ::: For more detailed implementation follow the steps below. diff --git a/spelling.txt b/spelling.txt index c64c1748..634806bf 100644 --- a/spelling.txt +++ b/spelling.txt @@ -110,3 +110,5 @@ RTCPIP VAPI vapi remuxing +swmansion +SimCam diff --git a/versioned_docs/version-0.28.0/how-to/client/ios-simulator-camera.mdx b/versioned_docs/version-0.28.0/how-to/client/ios-simulator-camera.mdx new file mode 100644 index 00000000..8c803bb8 --- /dev/null +++ b/versioned_docs/version-0.28.0/how-to/client/ios-simulator-camera.mdx @@ -0,0 +1,23 @@ +--- +sidebar_position: 17 +sidebar_label: "iOS Simulator Camera 📱" +description: Use SimCam to test camera features in the iOS Simulator without a physical device. +--- + +# iOS Simulator Camera Mobile + +The iOS Simulator has no camera, which means you normally need a physical device to test video streaming with Fishjam. + +[SimCam](https://simcam.swmansion.com/) is a macOS app that injects a virtual camera into the simulator. It works through standard AVFoundation APIs, so `@fishjam-cloud/react-native-client` picks it up without any changes to your code. + +## What SimCam provides + +- **Live camera feed**: your Mac's camera streamed into the simulator +- **Video file**: a video clip you can replay for consistent test scenarios +- **QR code**: inject QR codes without holding a phone up to the screen + +## Getting started + +1. Download and install SimCam from [simcam.swmansion.com](https://simcam.swmansion.com/). +2. Launch SimCam and pick a camera source. +3. Run your app in the simulator. The virtual camera shows up just like a real one. diff --git a/versioned_docs/version-0.28.0/how-to/client/managing-devices.mdx b/versioned_docs/version-0.28.0/how-to/client/managing-devices.mdx index 063b1f8d..1572a086 100644 --- a/versioned_docs/version-0.28.0/how-to/client/managing-devices.mdx +++ b/versioned_docs/version-0.28.0/how-to/client/managing-devices.mdx @@ -77,6 +77,10 @@ export function FlipButton() { +:::tip[Testing on iOS Simulator] +The iOS Simulator has no camera. [SimCam](https://simcam.swmansion.com/) solves this by injecting a virtual feed (your Mac's camera or a video file), so you can test without a physical device. See [Camera on iOS Simulator](./ios-simulator-camera). +::: + ## Turning Camera On and Off diff --git a/versioned_docs/version-0.28.0/tutorials/react-native-quick-start.mdx b/versioned_docs/version-0.28.0/tutorials/react-native-quick-start.mdx index addf5d57..6aa7be57 100644 --- a/versioned_docs/version-0.28.0/tutorials/react-native-quick-start.mdx +++ b/versioned_docs/version-0.28.0/tutorials/react-native-quick-start.mdx @@ -164,7 +164,7 @@ export default function Root() { ``` :::important -This won't work on the iOS Simulator, as the Simulator can't access the camera. Test on a real device. +The iOS Simulator has no camera. To test camera features, use a real device or [SimCam](https://simcam.swmansion.com/), which injects a virtual camera the simulator picks up automatically. See [Camera on iOS Simulator](../how-to/client/ios-simulator-camera). ::: For more detailed implementation follow the steps below.