ReplayKit is only available on certain iPhone, iPad and iPod Touch devices running iOS 9.0 or later.
ReplayKit allows you to record the audio and video of your game, along with user commentary through the microphone and user video through the camera. Start a recording with the StartRecording() function, and stop it with StopRecording(). You can preview the recording with the Preview() function, which launches a separate video viewer. In addition to local recordings, you can broadcast your recordings via StartBroadcasting(). There are also functions to pause, resume, and stop broadcasting.
using System; using UnityEngine; #if PLATFORM_IOS using UnityEngine.iOS; using UnityEngine.Apple.ReplayKit;
public class Replay : MonoBehaviour { public bool enableMicrophone = false; public bool enableCamera = false;
string lastError = ""; void OnGUI() { if (!ReplayKit.APIAvailable) { return; } var recording = ReplayKit.isRecording; string caption = recording ? "Stop Recording" : "Start Recording"; if (GUI.Button(new Rect(10, 10, 500, 200), caption)) { try { recording = !recording; if (recording) { ReplayKit.StartRecording(enableMicrophone, enableCamera); } else { ReplayKit.StopRecording(); } } catch (Exception e) { lastError = e.ToString(); } }
GUI.Label(new Rect(10, 220, 500, 50), "Last error: " + ReplayKit.lastError); GUI.Label(new Rect(10, 280, 500, 50), "Last exception: " + lastError);
if (ReplayKit.recordingAvailable) { if (GUI.Button(new Rect(10, 350, 500, 200), "Preview")) { ReplayKit.Preview(); } if (GUI.Button(new Rect(10, 560, 500, 200), "Discard")) { ReplayKit.Discard(); } } }
void Update() { // If the camera is enabled, show the recorded video overlaying the game. if (ReplayKit.isRecording && enableCamera) ReplayKit.ShowCameraPreviewAt(10, 350, 200, 200); else ReplayKit.HideCameraPreview(); } } #endif
APIAvailable | A boolean that indicates whether the ReplayKit API is available (where True means available). (Read Only) |
broadcastingAPIAvailable | A Boolean that indicates whether ReplayKit broadcasting API is available (true means available) (Read Only). Check the value of this property before making ReplayKit broadcasting API calls. On iOS versions prior to iOS 10, this property will have a value of false. |
broadcastURL | A string property that contains an URL used to redirect the user to an on-going or completed broadcast (Read Only). |
cameraEnabled | Camera enabled status. True, if camera enabled; false otherwise. |
isBroadcasting | Boolean property that indicates whether a broadcast is currently in progress (Read Only). |
isBroadcastingPaused | Boolean property that indicates whether a broadcast is currently paused (Read Only). |
isPreviewControllerActive | A boolean that indicates whether ReplayKit is currently displaying a preview controller. (Read Only) |
isRecording | A boolean that indicates whether ReplayKit is making a recording (where True means a recording is in progress). (Read Only) |
lastError | A string value of the last error incurred by the ReplayKit: Either 'Failed to get Screen Recorder' or 'No recording available'. (Read Only) |
microphoneEnabled | Microphone enabled status. True, if microphone enabled; false otherwise. |
recordingAvailable | A boolean value that indicates that a new recording is available for preview (where True means available). (Read Only) |
Discard | Discard the current recording. |
HideCameraPreview | Hide the camera preview view. |
PauseBroadcasting | Pauses current broadcast. Will pause currently on-going broadcast. If no broadcast is in progress, does nothing. |
Preview | Preview the current recording |
ResumeBroadcasting | Resumes current broadcast. Will resume currently on-going broadcast. If no broadcast is in progress, does nothing. |
ShowCameraPreviewAt | Shows camera preview at coordinates posX and posY. The preview is width by height in size. |
StartBroadcasting | Initiates and starts a new broadcast When StartBroadcast is called, user is presented with a broadcast provider selection screen, and then a broadcast setup screen. Once it is finished, a broadcast will be started, and the callback will be invoked. It will also be invoked in case of any error. |
StartRecording | Start a new recording. |
StopBroadcasting | Stops current broadcast. Will terminate currently on-going broadcast. If no broadcast is in progress, does nothing. |
StopRecording | Stop the current recording. |
BroadcastStatusCallback | Function called at the completion of broadcast startup. |