class.ilObjMediaObject.php

Go to the documentation of this file.

<?php
 
use ILIAS\Filesystem\Util\Convert\ImageOutputOptions;
use ILIAS\Filesystem\Util\Convert\LegacyImages;
use ILIAS\FileUpload\MimeType;
use ILIAS\FileUpload\FileUpload;
use ILIAS\FileUpload\DTO\UploadResult;
use ILIAS\FileUpload\Location;
use ILIAS\MediaObjects\InternalDomainService;
use ILIAS\MediaObjects\Thumbs\ThumbsManager;
use ILIAS\MediaObjects\MediaObjectManager;
 
define("IL_MODE_ALIAS", 1);
define("IL_MODE_OUTPUT", 2);
define("IL_MODE_FULL", 3);
 
class ilObjMediaObject extends ilObject
{
    public const DEFAULT_PREVIEW_SIZE = 80;
    protected ThumbsManager $thumbs;
    protected MediaObjectManager $manager;
    protected InternalDomainService $domain;
    protected ilObjUser $user;
    public bool $is_alias;
    public string $origin_id;
    public array $media_items;
    public bool $contains_int_link;
    private LegacyImages $image_converter;
 
    public function __construct(
        int $a_id = 0
    ) {
        global $DIC;
 
        $this->user = $DIC->user();
        $this->app_event_handler = $DIC["ilAppEventHandler"];
        $this->lng = $DIC->language();
        $this->is_alias = false;
        $this->media_items = array();
        $this->contains_int_link = false;
        $this->type = "mob";
        parent::__construct($a_id, false);
        $this->image_converter = $DIC->fileConverters()->legacyImages();
        $this->domain = $DIC->mediaObjects()->internal()->domain();
        $this->manager = $this->domain->mediaObject();
        $this->thumbs = $this->domain->thumbs();
    }
 
    public static function _exists(
        int $id,
        bool $reference = false,
        ?string $type = null
    ): bool {
        if (is_int(strpos($id, "_"))) {
            $a_id = ilInternalLink::_extractObjIdOfTarget($id);
        }
 
        if (parent::_exists($id) && ilObject::_lookupType($id) === "mob") {
            return true;
        }
        return false;
    }
 
    public function delete(): bool
    {
        $mob_logger = ilLoggerFactory::getLogger('mob');
        $mob_logger->debug("ilObjMediaObject: Delete called for media object ID '" . $this->getId() . "'.");
 
        if (!($this->getId() > 0)) {
            return false;
        }
 
        $usages = $this->getUsages();
 
        $mob_logger->debug("ilObjMediaObject: ... Found " . count($usages) . " usages.");
 
        if (count($usages) == 0) {
            // delete meta data of mob
            $this->deleteMetaData();
 
            // delete media items
            ilMediaItem::deleteAllItemsOfMob($this->getId());
 
            // this is just to make sure, there should be no entries left at
            // this point as they depend on the usage
            self::handleQuotaUpdate($this);
 
            // delete object
            parent::delete();
 
            $mob_logger->debug("ilObjMediaObject: ... deleted.");
        } else {
            foreach ($usages as $u) {
                $mob_logger->debug("ilObjMediaObject: ... usage type:" . $u["type"] .
                    ", id:" . $u["id"] .
                    ", lang:" . ($u["lang"] ?? "") .
                    ", hist_nr:" . ($u["hist_nr"] ?? "") . ".");
            }
            $mob_logger->debug("ilObjMediaObject: ... not deleted.");
        }
        return true;
    }
 
    protected function beforeMDUpdateListener(string $a_element): bool
    {
        switch ($a_element) {
            case 'General':
                // Update Title and description
                $paths = $this->domain->metadata()->learningObjectMetadata()->paths();
                $reader = $this->domain->metadata()->learningObjectMetadata()->read(
                    0,
                    $this->getId(),
                    $this->getType(),
                    $paths->custom()->withNextStep('general')->get()
                );
 
                ilObject::_writeTitle($this->getId(), $reader->firstData($paths->title())->value());
                ilObject::_writeDescription($this->getId(), $reader->firstData($paths->descriptions())->value());
                break;
        }
        return false;       // prevent parent from creating ilMD
    }
 
    protected function beforeCreateMetaData(): bool
    {
        $ilUser = $this->user;
 
        $this->domain->metadata()->learningObjectMetadata()->derive()->fromBasicProperties(
            $this->getTitle(),
            $this->getLongDescription(),
            $ilUser->getPref('language')
        )->forObject(0, $this->getId(), $this->getType());
 
        return false;   // avoid parent to create md
    }
 
    protected function beforeUpdateMetaData(): bool
    {
        $paths = $this->domain->metadata()->learningObjectMetadata()->paths();
 
        $manipulator = $this->domain->metadata()->learningObjectMetadata()
                                    ->manipulate(0, $this->getId(), $this->getType())
                                    ->prepareCreateOrUpdate($paths->title(), $this->getTitle());
 
        if ($this->getDescription() !== '') {
            $manipulator = $manipulator->prepareCreateOrUpdate($paths->firstDescription(), $this->getDescription());
        } else {
            $manipulator = $manipulator->prepareDelete($paths->firstDescription());
        }
 
        $manipulator->execute();
 
        return false;
    }
 
    protected function beforeDeleteMetaData(): bool
    {
        // Delete meta data
        $this->domain->metadata()->learningObjectMetadata()
                                 ->deleteAll(0, $this->getId(), $this->getType());
 
        return false;
    }
 
 
    public function addMediaItem(
        ilMediaItem $a_item
    ): void {
        $this->media_items[] = $a_item;
    }
 
    public function &getMediaItems(): array
    {
        return $this->media_items;
    }
 
    public function getMediaItem(
        string $a_purpose
    ): ?ilMediaItem {
        foreach ($this->media_items as $media_item) {
            if ($media_item->getPurpose() == $a_purpose) {
                return $media_item;
            }
        }
        return null;
    }
 
    public function removeMediaItem(
        string $a_purpose
    ): void {
        foreach ($this->media_items as $key => $media_item) {
            if ($media_item->getPurpose() == $a_purpose) {
                unset($this->media_items[$key]);
            }
        }
        // update numbers and keys
        $i = 1;
        $media_items = array();
        foreach ($this->media_items as $media_item) {
            $media_items [$i] = $media_item;
            $media_item->setMobId($this->getId());
            $media_item->setNr($i);
            $i++;
        }
        $this->media_items = $media_items;
    }
 
    public function removeAllMediaItems(): void
    {
        $this->media_items = array();
    }
 
    public function hasFullscreenItem(): bool
    {
        return $this->hasPurposeItem("Fullscreen");
    }
 
    public function hasPurposeItem(string $purpose): bool
    {
        if (is_object($this->getMediaItem($purpose))) {
            return true;
        } else {
            return false;
        }
    }
 
    public function read(): void
    {
        parent::read();
        ilMediaItem::_getMediaItemsOfMOb($this);
    }
 
    public function setAlias(bool $a_is_alias): void
    {
        $this->is_alias = $a_is_alias;
    }
 
    public function isAlias(): bool
    {
        return $this->is_alias;
    }
 
    public function setOriginID(string $a_id): void
    {
        $this->origin_id = $a_id;
    }
 
    public function getOriginID(): string
    {
        return $this->origin_id;
    }
 
    public function create(
        bool $a_create_meta_data = false,
        bool $a_save_media_items = true,
        int $from_mob_id = 0
    ): int {
        $id = parent::create();
 
        if (!$a_create_meta_data) {
            $this->createMetaData();
        }
        $this->manager->create(
            $id,
            $this->getTitle(),
            $from_mob_id
        );
 
        if ($a_save_media_items) {
            $media_items = $this->getMediaItems();
            for ($i = 0; $i < count($media_items); $i++) {
                $item = $media_items[$i];
                $item->setMobId($this->getId());
                $item->setNr($i + 1);
                $item->create();
            }
        }
 
        self::handleQuotaUpdate($this);
 
        $ilAppEventHandler = $this->app_event_handler;
        $ilAppEventHandler->raise(
            'components/ILIAS/MediaObjects',
            'create',
            array('object' => $this,
            'obj_type' => 'mob',
            'obj_id' => $this->getId())
        );
 
        return $id;
    }
 
    public function update(bool $a_upload = false): bool
    {
        parent::update();
 
        if (!$a_upload) {
            $this->updateMetaData();
        }
 
        // iterate all items
        $media_items = $this->getMediaItems();
        ilMediaItem::deleteAllItemsOfMob($this->getId());
 
        $j = 1;
        foreach ($media_items as $key => $val) {
            $item = $val;
            if (is_object($item)) {
                $item->setMobId($this->getId());
                $item->setNr($j);
                if ($item->getLocationType() == "Reference") {
                    $item->extractUrlParameters();
                }
                $item->create();
                $j++;
            }
        }
 
        self::handleQuotaUpdate($this);
        $ilAppEventHandler = $this->app_event_handler;
        $ilAppEventHandler->raise(
            'components/ILIAS/MediaObjects',
            'update',
            array('object' => $this,
                    'obj_type' => 'mob',
                    'obj_id' => $this->getId())
        );
 
        return true;
    }
 
    protected static function handleQuotaUpdate(
        ilObjMediaObject $a_mob
    ): void {
    }
 
    public static function _getDirectory(
        int $a_mob_id
    ): string {
        return ilFileUtils::getWebspaceDir() . "/" . self::_getRelativeDirectory($a_mob_id);
    }
 
    public static function _getRelativeDirectory(int $a_mob_id): string
    {
        return "mobs/mm_" . $a_mob_id;
    }
 
    public static function _getURL(
        int $a_mob_id
    ): string {
        return ilUtil::getHtmlPath(ilFileUtils::getWebspaceDir() . "/mobs/mm_" . $a_mob_id);
    }
 
    public static function _lookupItemPath(
        int $a_mob_id,
        bool $a_url_encode = false,
        bool $a_web = true,
        string $a_purpose = ""
    ): string {
        if ($a_purpose == "") {
            $a_purpose = "Standard";
        }
        $location = ilMediaItem::_lookupLocationForMobId($a_mob_id, $a_purpose);
        if (preg_match("/https?\:/i", $location)) {
            return $location;
        }
 
        if ($a_url_encode) {
            $location = rawurlencode($location);
        }
 
        $path = ($a_web)
            ? ILIAS_HTTP_PATH
            : ".";
 
        return $path . "/public/data/" . CLIENT_ID . "/mobs/mm_" . $a_mob_id . "/" . $location;
    }
 
    public function createDirectory(): void
    {
        $path = ilObjMediaObject::_getDirectory($this->getId());
        ilFileUtils::makeDirParents($path);
        if (!is_dir($path)) {
            throw new ilMediaObjectsException("Failed to create directory $path.");
        }
    }
 
    public function getFilesOfDirectory(
        string $dir_path = ""
    ): array {
        return $this->manager->getFilesOfPath(
            $this->getId(),
            $dir_path
        );
    }
 
    public function getXML(
        int $a_mode = IL_MODE_FULL,
        int $a_inst = 0,
        bool $a_sign_locals = false,
        bool $offline = false
    ): string {
        $ilUser = $this->user;
        $xml = "";
        switch ($a_mode) {
            case IL_MODE_ALIAS:
                $xml = "<MediaObject>";
                $xml .= "<MediaAlias OriginId=\"il__mob_" . $this->getId() . "\"/>";
                $media_items = $this->getMediaItems();
                for ($i = 0; $i < count($media_items); $i++) {
                    $item = $media_items[$i];
                    $xml .= "<MediaAliasItem Purpose=\"" . $item->getPurpose() . "\">";
 
                    // Layout
                    $width = ($item->getWidth() != "")
                        ? "Width=\"" . $item->getWidth() . "\""
                        : "";
                    $height = ($item->getHeight() != "")
                        ? "Height=\"" . $item->getHeight() . "\""
                        : "";
                    $halign = ($item->getHAlign() != "")
                        ? "HorizontalAlign=\"" . $item->getHAlign() . "\""
                        : "";
                    $xml .= "<Layout $width $height $halign />";
 
                    // Caption
                    if ($item->getCaption() != "") {
                        $xml .= "<Caption Align=\"bottom\">" .
                            $this->escapeProperty($item->getCaption()) . "</Caption>";
                    }
 
                    // Text Representation
                    if ($item->getTextRepresentation() != "") {
                        $xml .= "<TextRepresentation>" .
                            $this->escapeProperty($item->getTextRepresentation()) . "</TextRepresentation>";
                    }
 
                    // Parameter
                    $parameters = $item->getParameters();
                    foreach ($parameters as $name => $value) {
                        $xml .= "<Parameter Name=\"$name\" Value=\"" . $this->escapeProperty($value) . "\"/>";
                    }
                    $xml .= $item->getMapAreasXML();
                    $xml .= "</MediaAliasItem>";
                }
                break;
 
                // for output we need technical sections of meta data
            case IL_MODE_OUTPUT:
 
                // get first technical section
                //                              $meta = $this->getMetaData();
                $xml = "<MediaObject Id=\"il__mob_" . $this->getId() . "\">";
 
                $media_items = $this->getMediaItems();
                for ($i = 0; $i < count($media_items); $i++) {
                    $item = $media_items[$i];
 
                    $xml .= "<MediaItem Purpose=\"" . $item->getPurpose() . "\">";
                    if ($a_sign_locals && $item->getLocationType() == "LocalFile") {
                        // pre irss file
                        if (is_file($this->getDataDirectory() . "/" . $item->getLocation())) {
                            $location = ilWACSignedPath::signFile($this->getDataDirectory() . "/" . $item->getLocation());
                            $location = substr($location, strrpos($location, "/") + 1);
                        } else {
                            if ($offline) {
                                $location = $item->getLocation();
                            } else {
                                $location = $this->manager->getLocalSrc(
                                    $this->getId(),
                                    $item->getLocation()
                                );
                            }
                        }
                    } else {
                        $location = trim($item->getLocation());
                        // irss
                        if ($item->getLocationType() === "LocalFile" &&
                        !is_file($this->getDataDirectory() . "/" . $item->getLocation())) {
                            $location = $this->manager->getLocalSrc(
                                $this->getId(),
                                $item->getLocation()
                            );
                        }
                        if ($item->getLocationType() != "LocalFile") {  //#25941
                            $location = ilUtil::secureUrl($location); //#23518
                        }
                    }
 
                    $xml .= "<Location Type=\"" . $item->getLocationType() . "\">" .
                        $this->handleAmps($location) . "</Location>";
 
                    // Format
                    $xml .= "<Format>" . $item->getFormat() . "</Format>";
 
                    // Layout
                    $width = ($item->getWidth() != "")
                        ? "Width=\"" . $item->getWidth() . "\""
                        : "";
                    $height = ($item->getHeight() != "")
                        ? "Height=\"" . $item->getHeight() . "\""
                        : "";
                    $halign = ($item->getHAlign() != "")
                        ? "HorizontalAlign=\"" . $item->getHAlign() . "\""
                        : "";
                    $xml .= "<Layout $width $height $halign />";
 
                    // Caption
                    if ($item->getCaption() != "") {
                        $xml .= "<Caption Align=\"bottom\">" .
                            $this->escapeProperty($item->getCaption()) . "</Caption>";
                    }
 
                    // Text Representation
                    if ($item->getTextRepresentation() != "") {
                        $xml .= "<TextRepresentation>" .
                            $this->escapeProperty($item->getTextRepresentation()) . "</TextRepresentation>";
                    }
 
                    // Title
                    if ($this->getTitle() != "") {
                        $xml .= "<Title>" .
                            $this->escapeProperty($this->getTitle()) . "</Title>";
                    }
 
                    // Parameter
                    $parameters = $item->getParameters();
                    if ($item->getFormat() === "video/vimeo") {
                        $parameters = ilExternalMediaAnalyzer::extractVimeoParameters($item->getLocation());
                    }
                    foreach ($parameters as $name => $value) {
                        $xml .= "<Parameter Name=\"$name\" Value=\"" . $this->escapeProperty($value) . "\"/>";
                    }
                    $xml .= $item->getMapAreasXML();
 
                    // Subtitles
                    if ($item->getPurpose() == "Standard") {
                        $this->manager->generateMissingVTT($this->getId());
                        $srts = $this->getSrtFiles(true);
                        foreach ($srts as $srt) {
                            $def = "";
                            $meta_lang = "";
                            if ($ilUser->getLanguage() != $meta_lang &&
                                $ilUser->getLanguage() == $srt["language"]) {
                                $def = ' Default="true" ';
                            }
                            $xml .= "<Subtitle File=\"" . $srt["src"] .
                                "\" Language=\"" . $srt["language"] . "\" " . $def . "/>";
                        }
                    }
                    if ($this->getVideoPreviewPic(true)) {
                        $xml .= "<PreviewPic File=\"" . $this->getVideoPreviewPic(true) .
                            "\" />";
                    }
                    if ($item->getLocationType() == "LocalFile") {
                        $lpos = strrpos($location, "/");
                        $base_url = substr($location, 0, $lpos);
                        $xml .= "<Url Base=\"" . $base_url .
                            "\" />";
                    }
                    $xml .= "</MediaItem>";
                }
                break;
 
                // full xml for export
            case IL_MODE_FULL:
                $xml = "<MediaObject>";
 
                // Title and Identifier
                $xml .= "<Identifier Entry=\"il_" . IL_INST_ID . "_mob_" . $this->getId() . "\"/>";
                if ($this->getTitle() != "") {
                    $xml .= "<Title>" .
                        $this->escapeProperty($this->getTitle()) . "</Title>";
                }
 
                $media_items = $this->getMediaItems();
                for ($i = 0; $i < count($media_items); $i++) {
                    $item = $media_items[$i];
 
                    // highlight mode
                    $xml .= "<MediaItem Purpose=\"" . $item->getPurpose() . "\">";
 
                    // Location
                    $xml .= "<Location Type=\"" . $item->getLocationType() . "\">" .
                        $this->handleAmps($item->getLocation()) . "</Location>";
 
                    // Format
                    $xml .= "<Format>" . $item->getFormat() . "</Format>";
 
                    // Layout
                    $width = ($item->getWidth() != "")
                        ? "Width=\"" . $item->getWidth() . "\""
                        : "";
                    $height = ($item->getHeight() != "")
                        ? "Height=\"" . $item->getHeight() . "\""
                        : "";
                    $halign = ($item->getHAlign() != "")
                        ? "HorizontalAlign=\"" . $item->getHAlign() . "\""
                        : "";
                    $xml .= "<Layout $width $height $halign />";
 
                    // Caption
                    if ($item->getCaption() != "") {
                        $xml .= "<Caption Align=\"bottom\">" .
                            str_replace("&", "&amp;", $item->getCaption()) . "</Caption>";
                    }
 
                    // Text Representation
                    if ($item->getTextRepresentation() != "") {
                        $xml .= "<TextRepresentation>" .
                            str_replace("&", "&amp;", $item->getTextRepresentation()) . "</TextRepresentation>";
                    }
 
                    // Parameter
                    $parameters = $item->getParameters();
                    foreach ($parameters as $name => $value) {
                        $xml .= "<Parameter Name=\"$name\" Value=\"$value\"/>";
                    }
                    $xml .= $item->getMapAreasXML(true, $a_inst);
                    $xml .= "</MediaItem>";
                }
                break;
        }
        $xml .= "</MediaObject>";
        return $xml;
    }
 
    protected function escapeProperty(
        string $a_value
    ): string {
        return htmlspecialchars($a_value);
    }
 
 
    public function handleAmps(
        string $a_str
    ): string {
        $a_str = str_replace("&amp;", "&", $a_str);
        $a_str = str_replace("&", "&amp;", $a_str);
        return $a_str;
    }
 
    public function exportXML(
        ilXmlWriter $a_xml_writer,
        int $a_inst = 0
    ): void {
        $a_xml_writer->appendXML($this->getXML(IL_MODE_FULL, $a_inst));
    }
 
 
    public function exportFiles(
        string $a_target_dir
    ): void {
        $subdir = "il_" . IL_INST_ID . "_mob_" . $this->getId();
        ilFileUtils::makeDir($a_target_dir . "/objects/" . $subdir);
 
        $mobdir = ilFileUtils::getWebspaceDir() . "/mobs/mm_" . $this->getId();
        ilFileUtils::rCopy($mobdir, $a_target_dir . "/objects/" . $subdir);
    }
 
    public function modifyExportIdentifier(
        string $a_tag,
        string $a_param,
        string $a_value
    ): string {
        if ($a_tag == "Identifier" && $a_param == "Entry") {
            $a_value = ilUtil::insertInstIntoID($a_value);
        }
 
        return $a_value;
    }
 
 
    // EDIT METHODS: these methods act on the media alias in the dom
 
    public function setContainsIntLink(
        bool $a_contains_link
    ): void {
        $this->contains_int_link = $a_contains_link;
    }
 
    public function containsIntLink(): bool
    {
        return $this->contains_int_link;
    }
 
    public static function _deleteAllUsages(
        string $a_type,
        int $a_id,
        ?int $a_usage_hist_nr = 0,
        string $a_lang = "-"
    ): void {
        global $DIC;
 
        $ilDB = $DIC->database();
 
        $and_hist = "";
        if (!is_null($a_usage_hist_nr)) {
            $and_hist = " AND usage_hist_nr = " . $ilDB->quote($a_usage_hist_nr, "integer");
        }
 
        $mob_ids = array();
        $set = $ilDB->query("SELECT id FROM mob_usage" .
            " WHERE usage_type = " . $ilDB->quote($a_type, "text") .
            " AND usage_id = " . $ilDB->quote($a_id, "integer") .
            " AND usage_lang = " . $ilDB->quote($a_lang, "text") .
            $and_hist);
        while ($row = $ilDB->fetchAssoc($set)) {
            $mob_ids[] = $row["id"];
        }
 
        $q = "DELETE FROM mob_usage WHERE usage_type = " .
            $ilDB->quote($a_type, "text") .
            " AND usage_id= " . $ilDB->quote($a_id, "integer") .
            " AND usage_lang = " . $ilDB->quote($a_lang, "text") .
            $and_hist;
        $ilDB->manipulate($q);
 
        foreach ($mob_ids as $mob_id) {
            self::handleQuotaUpdate(new self($mob_id));
        }
    }
 
    public static function _getMobsOfObject(
        string $a_type,
        int $a_id,
        int $a_usage_hist_nr = 0,
        string $a_lang = "-"
    ): array {
        global $DIC;
 
        $ilDB = $DIC->database();
 
        $lstr = "";
        if ($a_lang != "") {
            $lstr = " AND usage_lang = " . $ilDB->quote($a_lang, "text");
        }
        $hist_str = "";
        if ($a_usage_hist_nr > 0) {
            $hist_str = " AND usage_hist_nr = " . $ilDB->quote($a_usage_hist_nr, "integer");
        }
 
        $q = "SELECT * FROM mob_usage WHERE " .
            "usage_type = " . $ilDB->quote($a_type, "text") . " AND " .
            "usage_id = " . $ilDB->quote($a_id, "integer") .
            $lstr . $hist_str;
        $mobs = array();
        $mob_set = $ilDB->query($q);
        while ($mob_rec = $ilDB->fetchAssoc($mob_set)) {
            $mob_id = (int) $mob_rec['id'];
            if (ilObject::_lookupType($mob_id) === "mob") {
                $mobs[$mob_id] = $mob_id;
            }
        }
 
        return $mobs;
    }
 
    public static function _saveUsage(
        int $a_mob_id,
        string $a_type,
        int $a_id,
        int $a_usage_hist_nr = 0,
        string $a_lang = "-"
    ): void {
        global $DIC;
 
        $ilDB = $DIC->database();
 
        $ilDB->replace(
            "mob_usage",
            array(
                "id" => array("integer", $a_mob_id),
                "usage_type" => array("text", $a_type),
                "usage_id" => array("integer", $a_id),
                "usage_lang" => array("text", $a_lang),
                "usage_hist_nr" => array("integer", $a_usage_hist_nr)
                ),
            array()
        );
 
        self::handleQuotaUpdate(new self($a_mob_id));
    }
 
    public static function _removeUsage(
        int $a_mob_id,
        string $a_type,
        int $a_id,
        int $a_usage_hist_nr = 0,
        string $a_lang = "-"
    ): void {
        global $DIC;
 
        $ilDB = $DIC->database();
 
        $q = "DELETE FROM mob_usage WHERE " .
            " id = " . $ilDB->quote($a_mob_id, "integer") . " AND " .
            " usage_type = " . $ilDB->quote($a_type, "text") . " AND " .
            " usage_id = " . $ilDB->quote($a_id, "integer") . " AND " .
            " usage_lang = " . $ilDB->quote($a_lang, "text") . " AND " .
            " usage_hist_nr = " . $ilDB->quote($a_usage_hist_nr, "integer");
        $ilDB->manipulate($q);
 
        self::handleQuotaUpdate(new self($a_mob_id));
    }
 
    public function getUsages(
        bool $a_include_history = true
    ): array {
        return self::lookupUsages($this->getId(), $a_include_history);
    }
 
    public static function lookupUsages(
        int $a_id,
        bool $a_include_history = true
    ): array {
        global $DIC;
 
        $ilDB = $DIC->database();
 
        $hist_str = "";
        if ($a_include_history) {
            $hist_str = ", usage_hist_nr";
        }
 
        // get usages in pages
        $q = "SELECT DISTINCT usage_type, usage_id, usage_lang" . $hist_str . " FROM mob_usage WHERE id = " .
            $ilDB->quote($a_id, "integer");
 
        if (!$a_include_history) {
            $q .= " AND usage_hist_nr = " . $ilDB->quote(0, "integer");
        }
 
        $us_set = $ilDB->query($q);
        $ret = array();
        while ($us_rec = $ilDB->fetchAssoc($us_set)) {
            $ut = "";
            $ct = 0;
            if (is_int(strpos($us_rec["usage_type"], ":"))) {
                $us_arr = explode(":", $us_rec["usage_type"]);
                $ut = $us_arr[1];
                $ct = $us_arr[0];
            }
 
            // check whether page exists
            $skip = false;
            if ($ut == "pg") {
                if (!ilPageObject::_exists($ct, $us_rec["usage_id"])) {
                    $skip = true;
                }
            }
 
            if (!$skip) {
                $ret[] = array(
                    "type" => $us_rec["usage_type"],
                    "id" => $us_rec["usage_id"],
                    "lang" => $us_rec["usage_lang"],
                    "hist_nr" => ($us_rec["usage_hist_nr"] ?? 0)
                );
            }
        }
 
        // get usages in media pools
        $q = "SELECT DISTINCT mep_id FROM mep_tree JOIN mep_item ON (child = obj_id) WHERE mep_item.foreign_id = " .
            $ilDB->quote($a_id, "integer") . " AND mep_item.type = " . $ilDB->quote("mob", "text");
        $us_set = $ilDB->query($q);
        while ($us_rec = $ilDB->fetchAssoc($us_set)) {
            $ret[] = array("type" => "mep",
                "id" => $us_rec["mep_id"]);
        }
 
        // get usages in news items (media casts)
        $news_usages = ilNewsItem::_lookupMediaObjectUsages($a_id);
        foreach ($news_usages as $nu) {
            $ret[] = $nu;
        }
 
 
        // get usages in map areas
        $q = "SELECT DISTINCT mob_id FROM media_item it, map_area area " .
            " WHERE area.item_id = it.id " .
            " AND area.link_type = " . $ilDB->quote("int", "text") . " " .
            " AND area.target = " . $ilDB->quote("il__mob_" . $a_id, "text");
        $us_set = $ilDB->query($q);
        while ($us_rec = $ilDB->fetchAssoc($us_set)) {
            $ret[] = array("type" => "map",
                "id" => $us_rec["mob_id"]);
        }
 
        // get usages in personal clipboards
        $users = ilObjUser::_getUsersForClipboadObject("mob", $a_id);
        foreach ($users as $user) {
            $ret[] = array("type" => "clip",
                "id" => $user);
        }
 
        return $ret;
    }
 
    public static function getParentObjectIdForUsage(
        array $a_usage,
        bool $a_include_all_access_obj_ids = false
    ): ?int {
        $cont_type = "";
        if (is_int(strpos($a_usage["type"], ":"))) {
            $us_arr = explode(":", $a_usage["type"]);
            $type = $us_arr[1];
            $cont_type = $us_arr[0];
        } else {
            $type = $a_usage["type"];
        }
 
        $id = $a_usage["id"];
        $obj_id = null;
 
        switch ($type) {
            // RTE / tiny mce
            case "html":
 
                switch ($cont_type) {
                    case "qpl":
                        // Question Pool *Question* Text (Test)
                        global $DIC;
                        $qinfo = $DIC->testQuestion()->getGeneralQuestionProperties($id);
                        if ($qinfo->getOriginalId() > 0) {
                            $obj_id = ilObjTest::_lookupTestObjIdForQuestionId($id);    // usage in test
                        } else {
                            $obj_id = (int) ($qinfo["obj_fi"] ?? 0);            // usage in pool
                        }
                        break;
 
                    case "spl":
                        // Question Pool *Question* Text (Survey)
                        $quest = SurveyQuestion::_instanciateQuestion($id);
                        if ($quest) {
                            $parent_id = $quest->getObjId();
 
                            // pool question copy - find survey, do not use pool itself
                            if ($quest->getOriginalId() &&
                                ilObject::_lookupType($parent_id) == "spl") {
                                $obj_id = (int) SurveyQuestion::_lookupSurveyObjId($id);
                            }
                            // original question (in pool or survey)
                            else {
                                $obj_id = (int) $parent_id;
                            }
 
                            unset($quest);
                        }
                        break;
 
                    case "exca":
                        // Exercise assignment
                        $returned_pk = $a_usage['id'];
                        // #15995 - we are just checking against exercise object
                        $obj_id = ilExSubmission::lookupExerciseIdForReturnedId($returned_pk);
                        break;
 
                    case "frm":
                        // Forum
                        $post_pk = $a_usage['id'];
                        $oPost = new ilForumPost($post_pk);
                        $frm_pk = $oPost->getForumId();
                        $obj_id = ilForum::_lookupObjIdForForumId($frm_pk);
                        break;
 
 
                    case "frm~d":
                        $draft_id = $a_usage['id'];
                        $oDraft = ilForumPostDraft::newInstanceByDraftId($draft_id);
 
                        $frm_pk = $oDraft->getForumId();
                        $obj_id = ilForum::_lookupObjIdForForumId($frm_pk);
                        break;
                    case "frm~h":
                        $history_id = $a_usage['id'];
                        $oHistoryDraft = new ilForumDraftsHistory($history_id);
                        $oDraft = ilForumPostDraft::newInstanceByDraftId($oHistoryDraft->getDraftId());
 
                        $frm_pk = $oDraft->getForumId();
                        $obj_id = ilForum::_lookupObjIdForForumId($frm_pk);
                        break;
                        // temporary items (per user)
                    case "frm~":
                    case "exca~":
                        $obj_id = (int) $a_usage['id'];
                        break;
 
                        // "old" category pages
                    case "cat":
                        // InfoScreen Text
                    case "tst":
                    case "svy":
                        // data collection
                    case "dcl":
                        $obj_id = (int) $id;
                        break;
                }
                break;
 
                // page editor
            case "pg":
 
                switch ($cont_type) {
                    // question feedback // parent obj id is q id
                    case "qfbg":
                    case "qpl":
 
                        if ($cont_type == "qfbg") {
                            $id = ilPageObject::lookupParentId($id, 'qfbg');
                        }
 
                        // Question Pool Question Pages
                        global $DIC;
                        $qinfo = $DIC->testQuestion()->getGeneralQuestionProperties($id);
                        if ($qinfo->getOriginalId() > 0) {
                            $obj_id = ilObjTest::_lookupTestObjIdForQuestionId($id);    // usage in test
                        } else {
                            $obj_id = $qinfo["obj_fi"];         // usage in pool
                        }
                        if ($obj_id == 0) {     // this is the case, if question is in learning module -> get lm id
                            $pinfo = ilPCQuestion::_getPageForQuestionId($id, "lm");
                            if ($pinfo && $pinfo["parent_type"] == "lm") {
                                $obj_id = ilLMObject::_lookupContObjID($pinfo["page_id"]);
                            }
                        }
                        break;
 
                    case "lm":
                        // learning modules
                        $obj_id = ilLMObject::_lookupContObjID($id);
                        break;
 
                    case "term":
                        $term_id = $id;
                        $obj_id = ilGlossaryTerm::_lookGlossaryID($term_id);
                        break;
 
                    case "wpg":
                        // wiki page
                        $obj_id = (int) ilWikiPage::lookupObjIdByPage($id);
                        break;
 
                    case "sahs":
                        // sahs page
                        // can this implementation be used for other content types, too?
                        $obj_id = ilPageObject::lookupParentId($id, 'sahs');
                        break;
 
                    case "prtf":
                        // portfolio
                        $obj_id = ilPortfolioPage::findPortfolioForPage($id);
                        break;
 
                    case "prtt":
                        // portfolio template
                        $obj_id = ilPortfolioTemplatePage::findPortfolioForPage($id);
                        break;
 
 
                    case "impr":
                        // imprint page - always id 1
                        // fallthrough
 
                    case "copa":
                    case "cstr":
                        $obj_id = $id;
                        break;
 
                    default:
                        $obj_id = ilPageObject::lookupParentId($id, $cont_type);
                        break;
                }
                break;
 
                // Media Pool
            case "mep":
                $obj_id = $id;
                break;
 
                // News Context Object (e.g. MediaCast)
            case "news":
                $obj_id = ilNewsItem::_lookupContextObjId($id);
                break;
        }
 
        return $obj_id;
    }
 
    public static function _resizeImage(
        string $a_file,
        int $a_width,
        int $a_height,
        bool $a_constrain_prop = false
    ): string {
        global $DIC;
        $file_path = pathinfo($a_file);
        $location = substr($file_path["basename"], 0, strlen($file_path["basename"]) -
                strlen($file_path["extension"]) - 1) . "_" .
            $a_width . "_" .
            $a_height . "." . $file_path["extension"];
        $target_file = $file_path["dirname"] . "/" .
            $location;
 
        $returned_target_file = $DIC->fileConverters()
            ->legacyImages()
            ->resizeToFixedSize(
                $a_file,
                $target_file,
                $a_width,
                $a_height,
                $a_constrain_prop
            );
 
        if ($returned_target_file !== $target_file) {
            throw new RuntimeException('Could not resize image');
        }
 
        return $location;
    }
 
    public static function getMimeType(
        string $a_file,
        bool $a_external = false
    ): string {
        $mime = MimeType::lookupMimeType($a_file, MimeType::APPLICATION__OCTET_STREAM, $a_external);
        return $mime;
    }
 
    public static function _determineWidthHeight(
        string $a_format,
        string $a_type,
        string $a_file,
        string $a_reference,
        bool $a_constrain_proportions,
        bool $a_use_original,
        ?int $a_user_width = null,
        ?int $a_user_height = null
    ): array {
        global $DIC;
 
        $lng = $DIC->language();
        $size = [];
        $wr = 0;
        $hr = 0;
        $width = 0;
        $height = 0;
 
        // determine width and height of known image types
        //$width = 640;
        //$height = 360;
        $info = "";
 
        /*
        if ($a_format == "audio/mpeg") {
            $width = 300;
            $height = 20;
        }*/
 
        if (ilUtil::deducibleSize($a_format)) {
            if ($a_type == "File") {
                $size = ilMediaImageUtil::getImageSize($a_file);
            } else {
                $size = ilMediaImageUtil::getImageSize($a_reference);
            }
        }
 
        if (!isset($size[0])) {
            $size[0] = 0;
        }
        if (!isset($size[1])) {
            $size[1] = 0;
        }
 
        if ($a_use_original) {
            if ($size[0] > 0 && $size[1] > 0) {
                //$width = $size[0];
                //$height = $size[1];
                $width = "";
                $height = "";
            } else {
                $info = $lng->txt("cont_could_not_determine_resource_size");
            }
        } else {
            $w = $a_user_width;
            $h = $a_user_height;
            $width = $w;
            $height = $h;
            //echo "<br>C-$width-$height-";
            if (ilUtil::deducibleSize($a_format) && $a_constrain_proportions) {
                if ($size[0] > 0 && $size[1] > 0) {
                    if ($w > 0) {
                        $wr = $size[0] / $w;
                    }
                    if ($h > 0) {
                        $hr = $size[1] / $h;
                    }
                    //echo "<br>+".$wr."+".$size[0]."+".$w."+";
                    //echo "<br>+".$hr."+".$size[1]."+".$h."+";
                    $r = max($wr, $hr);
                    if ($r > 0) {
                        $width = (int) round($size[0] / $r);
                        $height = (int) round($size[1] / $r);
                    }
                }
            }
            //echo "<br>D-$width-$height-";
        }
        //echo "<br>E-$width-$height-";
 
        if ($width == 0 && is_null($a_user_width)) {
            $width = "";
        }
        if ($height == 0 && is_null($a_user_height)) {
            $height = "";
        }
        return array("width" => $width, "height" => $height, "info" => $info);
    }
 
    public function getDataDirectory(): string
    {
        return ilFileUtils::getWebspaceDir() . "/mobs/mm_" . $this->getId();
    }
 
    public static function _saveTempFileAsMediaObject(
        string $name,
        string $tmp_name,
        bool $upload = true
    ): ilObjMediaObject {
        // create dummy object in db (we need an id)
        $media_object = new ilObjMediaObject();
        $media_object->setTitle($name);
        $media_object->setDescription("");
        $media_object->create();
 
        // determine and create mob directory, move uploaded file to directory
        $media_object->createDirectory();
        $mob_dir = ilObjMediaObject::_getDirectory($media_object->getId());
 
        $file = $mob_dir . "/" . $name;
        if ($upload) {
            $media_item = $media_object->addMediaItemFromLegacyUpload(
                "Standard",
                $tmp_name,
                $name,
                0,
                0,
                true,
                true
            );
        } else {
            $media_item = $media_object->addMediaItemFromLocalFile(
                "Standard",
                $tmp_name,
                $name
            );
            /*
            $media_item = new ilMediaItem();
            $media_object->addMediaItem($media_item);
            $media_item->setPurpose("Standard");
 
            copy($tmp_name, $file);
            // get mime type
            $format = ilObjMediaObject::getMimeType($file);
            $media_item->setFormat($format);
            $location = $name;
            $media_item->setLocation($location);
            $media_item->setLocationType("LocalFile");*/
        }
 
        // set real meta and object data
        $media_object->setTitle($name);
        $media_object->setDescription($media_item->getFormat());
        $media_item->setHAlign("Left");
 
        /*
        self::renameExecutables($mob_dir);
        ilMediaSvgSanitizer::sanitizeDir($mob_dir);     // see #20339
        */
 
        $media_object->update();
 
        return $media_object;
    }
 
    public function addMediaItemFromLegacyUpload(
        string $purpose,
        string $tmp_name,
        string $name,
        int $resize_width = 0,
        int $resize_height = 0,
        bool $constrain_proportions = true,
        bool $deduce_size = false
    ): \ilMediaItem {
        $media_item = new ilMediaItem();
        $this->addMediaItem($media_item);
        $media_item->setPurpose($purpose);
        //$location = self::fixFilename($_FILES[$upload_name]['name']);
        $location = $name;
        $this->manager->addFileFromLegacyUpload($this->getId(), $tmp_name);
 
        // get mime type
        $format = self::getMimeType($location, true);
 
        // resize standard images
        if ($resize_width > 0 && $resize_height > 0 && is_int(strpos($format, "image"))) {
            /*
            $location = ilObjMediaObject::_resizeImage(
                $file,
                $resize_width,
                $resize_height,
                $constrain_proportions
            );*/
        }
 
        if ($deduce_size) {
            /*
            if (ilUtil::deducibleSize($format)) {
                $size = ilMediaImageUtil::getImageSize($file);
                $media_item->setWidth($size[0]);
                $media_item->setHeight($size[1]);
            }*/
        }
 
        // set real meta and object data
        $media_item->setFormat($format);
        $media_item->setLocation($location);
        $media_item->setLocationType("LocalFile");
        if ($purpose === "Standard") {
            $this->generatePreviewPic(320, 240);
        }
        return $media_item;
    }
 
    public function addMediaItemFromUpload(
        string $purpose,
        UploadResult $result,
        string $upload_hash = "",
    ): \ilMediaItem {
        $media_item = new ilMediaItem();
        $this->addMediaItem($media_item);
        $media_item->setPurpose($purpose);
        $this->manager->addFileFromUpload($this->getId(), $result);
 
        // get mime type
        $format = self::getMimeType($result->getName(), true);
 
        // set real meta and object data
        $media_item->setFormat($format);
        $media_item->setLocation($result->getName());
        $media_item->setLocationType("LocalFile");
        if ($upload_hash !== "") {
            $media_item->setUploadHash($upload_hash);
        }
        if ($purpose === "Standard") {
            $this->generatePreviewPic(320, 240);
        }
        return $media_item;
    }
 
    public function addMediaItemFromLocalFile(
        string $purpose,
        string $tmp_name,
        string $name
    ): \ilMediaItem {
        $media_item = new ilMediaItem();
        $this->addMediaItem($media_item);
        $media_item->setPurpose($purpose);
        $location = $name;
        $this->manager->addFileFromLocal($this->getId(), $tmp_name, $name);
 
        // get mime type
        $format = self::getMimeType($location, true);
 
        // set real meta and object data
        $media_item->setFormat($format);
        $media_item->setLocation($location);
        $media_item->setLocationType("LocalFile");
        if ($purpose === "Standard") {
            $this->generatePreviewPic(320, 240);
        }
        return $media_item;
    }
 
    public function replaceMediaItemFromUpload(
        string $purpose,
        UploadResult $result,
        string $upload_hash = "",
    ): \ilMediaItem {
        $media_item = $this->getMediaItem($purpose);
        $this->manager->removeLocation($this->getId(), $media_item->getLocation());
        $this->manager->addFileFromUpload($this->getId(), $result);
 
        // get mime type
        $format = self::getMimeType($result->getName(), true);
 
        // set real meta and object data
        $media_item->setFormat($format);
        $media_item->setLocation($result->getName());
        $media_item->setLocationType("LocalFile");
        if ($upload_hash !== "") {
            $media_item->setUploadHash($upload_hash);
        }
        if ($purpose === "Standard") {
            $this->generatePreviewPic(320, 240);
        }
        return $media_item;
    }
 
    public function uploadAdditionalFile(
        string $a_name,
        string $tmp_name,
        string $a_subdir = "",
        string $a_mode = "move_uploaded"
    ): void {
        $a_subdir = str_replace("..", "", $a_subdir);
        if ($a_mode == "rename") {
            $this->manager->addFileFromLocal(
                $this->getId(),
                $tmp_name,
                $a_subdir . "/" . $a_name
            );
        } else {
            $this->manager->addFileFromLegacyUpload(
                $this->getId(),
                $tmp_name,
                $a_subdir . "/" . $a_name
            );
        }
    }
 
    public function addAdditionalFileFromUpload(
        UploadResult $result,
        string $subdir
    ): void {
        $this->manager->addFileFromUpload(
            $this->getId(),
            $result,
            $subdir
        );
    }
 
    public function uploadSrtFile(
        string $a_tmp_name,
        string $a_language,
        string $a_mode = "move_uploaded"
    ): bool {
        if (is_file($a_tmp_name) && $a_language != "") {
            $this->uploadAdditionalFile("subtitle_" . $a_language . ".vtt", $a_tmp_name, "srt", $a_mode);
            return true;
        }
        return false;
    }
 
    public function getSrtFiles(bool $vtt_only = false): array
    {
        return $this->manager->getSrtFiles($this->getId(), $vtt_only);
    }
 
    public function makeThumbnail(
        string $source,
        string $thumbname,
    ): void {
        $format = self::getMimeType($source, true);
        $this->manager->generatePreview(
            $this->getId(),
            $source,
            true,
            $format,
            1,
            $thumbname
        );
    }
 
    public function removeAdditionalFile(
        string $a_file
    ): void {
        $this->manager->removeLocation(
            $this->getId(),
            $a_file
        );
    }
 
 
    public function getLinkedMediaObjects(
        array $a_ignore = []
    ): array {
        $linked = array();
 
        // get linked media objects (map areas)
        $med_items = $this->getMediaItems();
 
        foreach ($med_items as $med_item) {
            $int_links = ilMapArea::_getIntLinks($med_item->getId());
            foreach ($int_links as $k => $int_link) {
                if ($int_link["Type"] == "MediaObject") {
                    $l_id = ilInternalLink::_extractObjIdOfTarget($int_link["Target"]);
                    if (ilObject::_exists($l_id)) {
                        if (!in_array($l_id, $linked) &&
                            !in_array($l_id, $a_ignore)) {
                            $linked[] = $l_id;
                        }
                    }
                }
            }
        }
        //var_dump($linked);
        return $linked;
    }
 
    public static function isTypeAllowed(
        string $a_type
    ): bool {
        global $DIC;
        return in_array($a_type, iterator_to_array(
            $DIC->mediaObjects()->internal()->domain()->mediaType()->getAllowedSuffixes()
        ), true);
    }
 
    public function duplicate(): ilObjMediaObject
    {
        $new_obj = new ilObjMediaObject();
        $new_obj->setTitle($this->getTitle());
        $new_obj->setDescription($this->getDescription());
 
        // media items
        foreach ($this->getMediaItems() as $key => $val) {
            $new_obj->addMediaItem($val);
        }
 
        $new_obj->create(
            false,
            true,
            $this->getId()              // "from" id
        );
 
        // meta data
        $this->domain->metadata()->learningObjectMetadata()
                                 ->derive()
                                 ->fromObject(0, $this->getId(), "mob")
                                 ->forObject(0, $new_obj->getId(), "mob");
 
        return $new_obj;
    }
 
    public function uploadVideoPreviewPic(
        array $a_prevpic
    ): void {
        // remove old one
        if ($this->getVideoPreviewPic(true) != "") {
            $this->removeAdditionalFile($this->getVideoPreviewPic(true));
        }
 
        $pi = pathinfo($a_prevpic["name"]);
        $ext = $pi["extension"];
        if (in_array($ext, array("jpg", "jpeg", "png"))) {
            $this->uploadAdditionalFile("mob_vpreview." . $ext, $a_prevpic["tmp_name"]);
        }
    }
 
    public function generatePreviewPic(
        int $a_width,
        int $a_height,
        int $sec = 1
    ): void {
        $logger = $GLOBALS['DIC']->logger()->mob();
 
        $item = $this->getMediaItem("Standard");
        if ($item->getFormat() === "image/svg+xml") {
            return;
        }
 
        $logger->debug("Generate preview pic...");
        $logger->debug("..." . $item->getFormat());
 
        $this->manager->generatePreview(
            $this->getId(),
            $item->getLocation(),
            $item->getLocationType() === "LocalFile",
            $item->getFormat(),
            $sec
        );
    }
 
    public function getVideoPreviewPic(
        bool $a_filename_only = false
    ): string {
 
        if (!$a_filename_only) {
            $src = $this->thumbs->getPreviewSrc($this->getId());
            if ($src !== "") {
                return $src;
            }
        }
 
        $dir = ilObjMediaObject::_getDirectory($this->getId());
        $ppics = array("mob_vpreview.jpg",
            "mob_vpreview.jpeg",
            "mob_vpreview.png");
        $med = $this->getMediaItem("Standard");
        if ($med && $med->getFormat() === "image/svg+xml" && $med->getLocationType() === "LocalFile") {
            $ppics[] = $med->getLocation();
        }
        foreach ($ppics as $p) {
            if (is_file($dir . "/" . $p)) {
                if ($a_filename_only) {
                    return $p;
                } else {
                    return $dir . "/" . $p;
                }
            }
        }
        return "";
    }
 
    public static function fixFilename(
        string $a_name
    ): string {
        $a_name = ilFileUtils::getASCIIFilename($a_name);
 
        $rchars = array("`", "=", "$", "{", "}", "'", ";", " ", "(", ")");
        $a_name = str_replace($rchars, "_", $a_name);
        $a_name = str_replace("__", "_", $a_name);
        return $a_name;
    }
 
 
    public function getMultiSrtUploadDir(): string
    {
        return ilObjMediaObject::_getDirectory($this->getId()) . "/srt/tmp";
    }
 
 
    public function uploadMultipleSubtitleFile(
        array $a_file
    ): void {
        $lng = $this->lng;
 
        if (!is_file($a_file["tmp_name"])) {
            throw new ilMediaObjectsException($lng->txt("mob_file_could_not_be_uploaded"));
        }
 
        $dir = $this->getMultiSrtUploadDir();
        ilFileUtils::delDir($dir, true);
        ilFileUtils::makeDirParents($dir);
        ilFileUtils::moveUploadedFile($a_file["tmp_name"], "multi_vtt.zip", $dir . "/" . "multi_vtt.zip");
        $this->domain->resources()->zip()->unzipFile($dir . "/multi_vtt.zip");
    }
 
    public function clearMultiSrtDirectory(): void
    {
        ilFileUtils::delDir($this->getMultiSrtUploadDir());
    }
 
    public function getMultiSrtFiles(): array
    {
        $items = array();
 
        $lang_codes = $this->domain->metadata()->getLOMLanguageCodes();
 
        $dir = $this->getMultiSrtUploadDir();
        $files = ilFileUtils::getDir($dir);
        foreach ($files as $k => $i) {
            // check directory
            if ($i["type"] == "file" && !in_array($k, array(".", ".."))) {
                if (pathinfo($k, PATHINFO_EXTENSION) == "vtt") {
                    $lang = "";
                    if (substr($k, strlen($k) - 7, 1) == "_") {
                        $lang = substr($k, strlen($k) - 6, 2);
                        if (!in_array($lang, $lang_codes)) {
                            $lang = "";
                        }
                    }
                    $items[] = array("filename" => $k, "lang" => $lang);
                }
            }
        }
        return $items;
    }
 
    public static function renameExecutables(
        string $a_dir
    ): void {
        ilFileUtils::renameExecutables($a_dir);
        if (!self::isTypeAllowed("html")) {
            ilFileUtils::rRenameSuffix($a_dir, "html", "sec");        // see #20187
        }
    }
 
    public function getExternalMetadata(): void
    {
        // see https://oembed.com/
        $st_item = $this->getMediaItem("Standard");
        if ($st_item->getLocationType() == "Reference") {
            if (ilExternalMediaAnalyzer::isVimeo($st_item->getLocation())) {
                $st_item->setFormat("video/vimeo");
                $par = ilExternalMediaAnalyzer::extractVimeoParameters($st_item->getLocation());
                $meta = ilExternalMediaAnalyzer::getVimeoMetadata($par["id"]);
                $this->setTitle($meta["title"] ?? "");
                $description = str_replace("\n", "", $meta["description"] ?? "");
                $description = str_replace(["<br>", "<br />"], ["\n", "\n"], $description);
                $description = strip_tags($description);
                $this->setDescription($description);
                $st_item->setDuration((int) ($meta["duration"] ?? 0));
                $url = parse_url($meta["thumbnail_url"] ?? "");
                $file = basename($url["path"]);
                $ext = pathinfo($file, PATHINFO_EXTENSION);
                if ($ext == "") {
                    $ext = "jpg";
                }
                $this->manager->addPreviewFromUrl(
                    $this->getId(),
                    $meta["thumbnail_url"],
                    "/mob_vpreview." . $ext
                );
            }
            if (ilExternalMediaAnalyzer::isYoutube($st_item->getLocation())) {
                $st_item->setFormat("video/youtube");
                $par = ilExternalMediaAnalyzer::extractYoutubeParameters($st_item->getLocation());
                try {
                    $meta = ilExternalMediaAnalyzer::getYoutubeMetadata($par["v"]);
                    $this->setTitle($meta["title"] ?? "");
                    $description = str_replace("\n", "", $meta["description"] ?? "");
                } catch (Exception $e) {
                    $this->setTitle($st_item->getLocation());
                    $description = "";
                }
                $description = str_replace(["<br>", "<br />"], ["\n", "\n"], $description);
                $description = strip_tags($description);
                $this->setDescription($description);
                $st_item->setDuration((int) ($meta["duration"] ?? 0));
                $thumbnail_url = $meta["thumbnail_url"] ?? "";
                $url = parse_url($thumbnail_url);
                if ($thumbnail_url !== "") {
                    $mob_logger = ilLoggerFactory::getLogger('mob');
                    $file = basename($url["path"]);
                    $this->manager->addPreviewFromUrl(
                        $this->getId(),
                        $meta["thumbnail_url"],
                        "/mob_vpreview." .
                        pathinfo($file, PATHINFO_EXTENSION)
                    );
                }
            }
        }
    }
 
    public function getStandardSrc(): string
    {
        return $this->getLocationSrc("Standard");
    }
 
    public function getFullscreenSrc(): string
    {
        return $this->getLocationSrc("Fullscreen");
    }
 
    protected function getLocationSrc(string $purpose): string
    {
        return (string) $this->getMediaItem($purpose)?->getLocationSrc();
    }
}