既知のエラー
edit_item の raw shape 更新
- 間違い:
{ "id": "abc", "fromFrame": 30 } - 正しい:
{ "json": "{\"updates\":[{\"id\":\"abc\",\"fromFrame\":30}]}" } - 一般的な移動、トリム、トラック変更にもこの同じ
updates形状を使用してください。
edit_item の raw shape 追加
- 新しいアイテムは
jsonトランザクションのadds配列内に配置します:{ "json": "{\"adds\":[{...}]}" } - 単純な動画配置には
edit_itemを使用します。例:{ "json": "{\"adds\":[{\"type\":\"video\",\"assetId\":\"...\",\"fromFrame\":0}]}" }
タイムラインの重複
- エラーテキスト:
Overlap: updated item at ... would overlap existing item at ... on this track. - 書き込みを強制したり、競合するアイテムを黙って削除したりしないでください。
- 利用可能な
trackIdを明示的に指定してedit_itemトランザクションを再試行します。例えば、"trackId":"V2"を含む更新を行うか、どのレイヤーを優先するかユーザーに尋ねてください。
ワークスペースパスの制限
- 外部 MCP の
push_assetはfilePathとして公開http(s)URL のみを受け入れます。ローカルパス、ワークスペースパス、チャット添付ファイルパスは拒否されます。 - モーショングラフィックアセットの場合は、
create_motion_graphic_from_code({ code:"...", name, width, height, durationInFrames })を介して JSX ソースを渡してください。push_assetはインラインのcode引数を受け入れなくなりました。 - ローカルメディアをワークスペースにコピーすることは、動画/オーディオ/画像/GIF のインポートの修正方法ではありません。代わりに
asset-importとimport_mediaを使用してください。 import_media action=create_sessionを使用し、その後、クライアント側のファイルに対して返されたトークンを使用して OpenChatCut メディアインポートヘルパーを一度実行してください。
ブラウザでの動画変換失敗
- エラーテキストにはよく
Unable to convert video without dropping audio/video tracksやunknown_source_codecが含まれます。 - OpenChatCut メディアインポートヘルパーを再実行してください。このヘルパーはフロントエンド側の変換を担当し、変換が不可能な場合はユーザーが対処可能なエラーを表示します。
- 回避策として、同じファイルをエディタ UI から再インポートするようユーザーに依頼しないでください。変換パスは同じであり、エラーは繰り返されます。ソースを修正するか（
ffmpegでローカル再エンコード）、別のファイルを選択してください。 - 置き換えアセットがアップロード/トランスコードされたら、使用されていない元の失敗アセットを削除してください。最終的なクリーンなメディアプールは、失敗したインポートとその置き換えのように見えるのではなく、成功したインポートのように見えるべきです。
モーショングラフィックの要件
push_asset(type:"motion-graphic")にはwidth、height、およびdurationまたはdurationInFramesが必要です。- MG コードは OpenChatCut バリデータを通過する必要があります。
- 生成された MG コードではルートの
AbsoluteFillは有効ではありません。代わりにスケーリング可能なルートdivを使用してください。 - MG コード内でトップレベルの
scaleという名前のローカル変数を宣言しないでください。バリデータ/ランタイムがその識別子を既に予約している可能性があります。uiScaleなどの具体的な名前を使用してください。
ローカル開発時の Zero に関する注意点
- バックエンドがデフォルト以外のポートで実行されている場合は、一致する Zero view-syncer 設定を使用してください。
- この POC では、バックエンド
3010、エディタ5177、view-syncer4850は、以前の3000/5173/4848スタックから意図的に分離されています。
タイムラインフレームレンダラに関する注意点
view_timeline_framesが 1 フレームで失敗しても、プロジェクト書き込みパスは正常である可能性があります。何かを結論付ける前に、より少ないフレーム数または異なる時間で再試行してください。- まだ
blob:プレースホルダーにあるアセット（アップロード中）は空としてレンダリングされます。空白フレームをバグとして扱う前に、track_progress target=uploadを待ってください。 - ツールが対象フレームを視覚的に確認できる画像コンテンツを返さない限り、視覚的な証明成功を報告しないでください。