Search Endpoint Response Conflict (OC 15 vs. OC 16+)

[ferishili]

Description

A breaking change occurred between Opencast 15 and 16 in the way data is returned from the search endpoint. This caused issues for nearly all external applications (e.g., LMSes) when retrieving episodes and related data.
To ensure a consistent and uniform solution, it was decided that this issue should be addressed within the Opencast PHP Library rather than in each LMS individually.

Reference: Opencast ILIAS OpenCast PR #375

Solution

Since the library itself does not control the data returned by Opencast, a utility class called OcUtils was introduced to help LMSes handle these changes efficiently.
The OcUtils class provides a method called findValueByKey, which allows extracting a targeted value from an object or array, regardless of its structure.

More on usage: Opencast PHP Library PR #38

What Needs to Change

The following section should be updated to leverage OcUtils::findValueByKey:

LivePlayerDataBuilder.php#L29

[dagraf]

In meeting: Solves a conflicts. Solution for later conflicts. Very short to introduce. Will be taken care of by @ferishili as soon as the other PR it depends on got merged.