As I understand it **, getMatchName should return the name of the clip (expl ABC.mp3), whereas getName() should return the a user defined name (in UI via clip → right click → “rename”).
However, calling ‘getMatchingName’ never returns anything.
Repro:
- Manually:
- abc.mp3 file in the ProjectIem Bin
- move abc.mp3 into a track in the active sequence
- Rename the AudioClipTrackItem (right click on item in timeline → rename → “Foobar”)
- (Note that “Reveal in Project“ still highlight the correct file ‘abc.mp3’, which I assume should be the ‘getMatchingName’ in UXP)
- Scripting:
- Retrieve all elements: project, sequence, audiotrack, audiocliptrackItem
- call
AudioClipTrackItem::getMatchName()
Expected:
- getMatchName() returns “abc.mp3“
- getName() return “Foobar“
Actual:
- getMatchName() returns ““
- getName() return “Foobar“
( Note: Obviously in code above I can do const projItem = await items[i].getProjectItem() followed by projItem.name to get the internal name - but then what is the point of the getMatchName API ? )
.
.
.
** documentation is quite sparse on this - so unable to confirm my understanding is the correct one