ProtectStreamUntil

Protects a playback stream from being purged (but not deleted) for the given number of days (from now). If the number of days given is less than the normal purge interval days (from createdAt), the longer protection date is applied. Can only be called by users involved in the playback stream.

Service	Operation
playbackStream	PROTECT_STREAM_UNTIL

Method Parameters

Parameter	Description
playbackStreamId	Identifies the stream to protect.
numDays	The number of days the stream is to be protected (from now).

Usage

http://localhost:3000

C#

string playbackStreamId = "streamId";
int numDays = 365;

SuccessCallback successCallback = (response, cbObject) =>
{
    Debug.Log(string.Format("Success | {0}", response));
};
FailureCallback failureCallback = (status, code, error, cbObject) =>
{
    Debug.Log(string.Format("Failed | {0}  {1}  {2}", status, code, error));
};

_bc.PlaybackstreamService.ProtectStreamUntil(playbackStreamId, numDays, successCallback, failureCallback);

C++

const char *playbackStreamId = "streamId";
int numDays = 365;
_bc.getPlaybackstreamService().protectStreamUntil(playbackStreamId, numDays, this);

Objective-C

NSString *playbackStreamId = @"streamId";
int numDays = 365;
BCCompletionBlock successBlock; // define callback
BCErrorCompletionBlock failureBlock; // define callback
[[_bc playbackStreamService] protectStreamUntil:
             playbackStreamId:playbackStreamId
                      numDays:numDays
              completionBlock:successBlock
         errorCompletionBlock:failureBlock
                     cbObject:nil]

Java

String playbackStreamId = "streamId";
int numDays = 365;
this; // implements IServerCallback
_bc.getPlaybackstreamService.protectStreamUntil(playbackStreamId, numDays, this);

public void serverCallback(ServiceName serviceName, ServiceOperation serviceOperation, JSONObject jsonData)
{
    System.out.print(String.format("Success | %s", jsonData.toString()));
}
public void serverError(ServiceName serviceName, ServiceOperation serviceOperation, int statusCode, int reasonCode, String jsonError)
{
    System.out.print(String.format("Failed | %d %d %s", statusCode,  reasonCode, jsonError.toString()));
}

JavaScript

var playbackStreamId = "streamId";
var numDays = 365;
_bc.playbackStream.protectStreamUntil(playbackStreamId, numDays, result =>
{
  var status = result.status;
  console.log(status + " : " + JSON.stringify(result, null, 2));
});

Dart

var  playbackStreamId = "streamId";
var  numDays = 365;

ServerResponse result = await _bc.playbackStreamService.protectStreamUntil(playbackStreamId:playbackStreamId, numDays:numDays);

if (result.statusCode == 200) {
    print("Success");
} else {
    print("Failed ${result.error['status_message'] ?? result.error}");
}

Cloud Code

var playbackStreamId = "streamId";
var numDays = 365;
var playbackStreamProxy = bridge.getPlaybackStreamServiceProxy();

var postResult = playbackStreamProxy.protectStreamUntil(playbackStreamId, numDays);

Raw

{
    "service":"playbackStream",
    "operation":"PROTECT_STREAM_UNTIL",
    "data":{
        "playbackStreamId":"streamId",
        "numDays":365
    }
}

JSON Response

{
    "data": {
        "protectedUntil": "2025-10-15 19:46:20"
    },
    "status": 200
}