Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Added AJA Bridge Live documentation #743

Open
wants to merge 3 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
56 changes: 56 additions & 0 deletions connector/doc/AJA_Bridge_Live.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
---
uid: Connector_help_AJA_Bridge_Live
---

# AJA Bridge Live

## About

The AJA Bridge Live connector enables seamless integration with AJA Bridge Live, a high-performance turnkey solution for SDI video encoding, decoding, transcoding, and streaming. Designed for remote production, live contribution, and content delivery, this connector allows users to monitor and configure critical workflows while ensuring reliable, cost-effective video transport across networks.

## Key Features

**System monitoring**: Retrieve system details such as software versions and real-time GPU/CPU utilization for performance monitoring.

**Network interface management**: Monitor network interfaces and bandwidth utilization, and ensure optimal connectivity for uninterrupted streaming.

**Pipeline control & configuration**: Start, stop, and modify pipelines dynamically, adjusting video, audio, and caption settings as needed.

**Input & output stream management**: Configure input and output streams with flexible encoding and transport options, including NDI, SRT, and RTMP.

## Use Cases
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These use cases seem related to the AJA Bridge Live itself, instead of to the connector. However, these should in fact illustrate the benefits of the connector. Could you adjust this?


### Use Case 1: Replacing Satellite Uplink with IP Streaming

**Challenge**: Traditional satellite uplink solutions are expensive and require extensive infrastructure, making them inefficient for modern live broadcasts.

**Solution**: AJA Bridge Live allows broadcasters to replace satellite transponders with a simple ISP connection, leveraging bidirectional IP transport for reliable video streaming.

**Benefit**: Significant cost savings, reduced complexity, and improved flexibility for remote productions and live events.

### Use Case 2: Dynamic Multi-Codec Transcoding

**Challenge**: Live production environments require real-time transcoding across multiple formats to ensure compatibility with different platforms.

**Solution**: Bridge Live supports multiple codecs (H.264, HEVC, JPEG XS, MPEG-2) and can dynamically transcode streams to meet delivery requirements.

**Benefit**: Enhanced compatibility with CDNs like YouTube, Twitch, and Facebook Live, enabling seamless content distribution.

### Use Case 3: High-Redundancy Live Streaming

**Challenge**: Live video streams are vulnerable to network issues such as packet loss, jitter, and latency fluctuations.

**Solution**: With SMPTE 2022-7 hitless redundancy, AJA Bridge Live ensures seamless failover by transmitting identical streams across independent network paths.

**Benefit**: Increased reliability, reduced risk of video interruptions, and optimized quality of experience for viewers.

## Technical Reference

### Prerequisites

- Network access: AJA Bridge Live must be accessible over the network for API communication.
- Authentication configuration: Basic authentication credentials (username and password) must be set up.
- Pipeline configuration: Users should pre-define input and output settings for efficient stream management.

> [!NOTE]
> For detailed technical information, refer to our [technical documentation](xref:Connector_help_AJA_Bridge_Live_Technical).
37 changes: 37 additions & 0 deletions connector/doc/AJA_Bridge_Live_Technical.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
---
uid: Connector_help_AJA_Bridge_Live_Technical
---

# AJA Bridge Live

## About

BRIDGE LIVE is the broadcast-quality, low-latency turnkey system for REMI, synchronous multi-channel video contribution, remote collaboration, direct-to-audience streaming, and multi bit rate/multi format delivery.

## Configuration

### Connections

#### HTTP Connection - Main Connection

This connector uses an HTTP connection and requires the following input during element creation:

HTTP CONNECTION:

- **IP address/host**: The polling IP or URL of the destination.
- **IP port**: The IP port of the destination.
- **Device address**: The bus address of the device. If the proxy server has to be bypassed, specify *BypassProxy*.

### Initialization

The **Configuration** subpage contains the **Username** and **Password** fields. These fields are used to authenticate the user to the device. These fields must be filled in for the connector to be able to retrieve information.

## How to use

REST API is used to retrieve the device information. The connector can be used to retrieve the device information and monitor the device status.

The **Pipelines** page shows information about all available pipelines. You can also start and stop pipelines from this page.

Pipelines can be edited from the **Inputs** and **Outputs** pages.

All sets to the device can be found on the **Pipeline Sets** page.
5 changes: 5 additions & 0 deletions connector/toc.yml
Original file line number Diff line number Diff line change
Expand Up @@ -256,6 +256,11 @@
topicUid: Connector_help_AIRSYS_UNICOOL_ASMUC
- name: AJA
items:
- name: AJA Bridge Live
topicUid: Connector_help_AJA_Bridge_Live
items:
- name: AJA Bridge Live Technical
topicUid: Connector_help_AJA_Bridge_Live_Technical
- name: AJA IPR-10G2-HDMI
topicUid: Connector_help_AJA_IPR-10G2-HDMI
- name: AJA IPT-10G2-HDMI
Expand Down