Ninja Docs

iOS (iPhone/iPad)

Last updated November 17th 2021; keep in mind, this article may become dated quickly.
VDO.Ninja has been tested with iOS v12 thru v15, but iOS v10 and under is strictly not supported. Older iPad and iPhone devices as a result are not compatible and likely never will be; an iPhone 5 for example will never be supported.
Please upgrade your iOS to at least v13.4 to avoid some critical bugs, although even newer is generally better.

1080p mode

H264 is the default video encoder on iOS, yet H264 only supports up to 720p30 on iOS 14 or older. On iOS 15 devices, H264 (the default codec used), supports 1080p30. A frame rate of 60-fps is still not supported though.
Both new and old iOS devices support 1080p30 when using the VP8 codec, which uses software-encoding rather than hardware. You may need to manually specific &width and &height to access 1080p mode on iOS 14 and older, but you can use also &quality=0 on iOS 15 and newer.
VP9 is supported on iOS 14, but you have to enable it as an experimental flag in the iOS Safari advanced settings. It supports 1080p, software-based encoding, and acts a lot like VP8. It generally is finicky, with low-frame rates being common, so use at your own risk.

Microphones and Audio

External microphones are supported on iOS, however iOS devices can be very finicky as to whether they work or not. A strong signal from your microphone and a proper connector (3.5mm TRRS and/or a legitimate Lightning adapter with microphone support). It should automatically work if it works. There is no drop down option for "external microphone" that you need to select in VDO.Ninja; the iOS device manages it automatically.
Not all 3.5mm to Lightning adapters will be compatible. One that I have tested for myself that does seem to work is this one:
AirPods can create clicking or distortion if used as a microphone; please ensure they are fully-charged if you intend to use them in a live production. If they are on low-power, they will create audible problems.
Audio quality from an iOS generally is pretty low quality. Disabling audio enhancements can sometimes help improve the clarity. It is recommended that the user be wearing headphones though to avoid any feedback issues.
iOS does not work with the volume visualizer meter; it causes clicking noises when used, so it has been disabled.
If willing to use Android, some users have noted that Firefox for Android often works with USB microphones.

Random issues

  • If full-screening a video on iOS devices, sometimes that can cause the outbound video to freeze.
  • Video out from an iOS device may initially be choppy; this usually smooths out over the course of seconds to a minute. If not, try to lower the resolution.
  • If your camera does not load or fails to load, fully close Safari / Chrome, and then try again. There seems to be an issue where old tabs or idle apps can block VDO.Ninja from accessing the camera.
  • Video shared by an iPhone/iPad to other guests in a group room may be choppy or of low-quality. This is intentional, as otherwise the iPhone would overheat or become too slow to use. Adding &forceios to the URL of a specific guest can force a different, smoother, behavior for them, but use it sparingly.

Limited features; no focus/exposure control

iOS does not yet support for many features that VDO.Ninja would like to make use of. It lacks zoom, focus, screen-sharing, exposure, and many other advanced options. These are features Apple needs to enable and allow the browser to access, which currently it does not.

Native app option

There is a basic native iOS app provided by VDO.Ninja at this time, but it is extremely basic. It lacks useful screen-capture support, group-room support, and password support. It does work with the Torch light function though, and it's useful to have when Safari refuses to work.
Supporting a native app for iOS takes a lot of resources and time, so it's being developed in tandem with the Android native app using a mobile development framework.
Last modified 3mo ago