feat: notify buffer format in context

[asterwyx]

Source buffer format can be reused in context.

[deepin-ci-robot]

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: asterwyx

The full list of commands accepted by this bot can be found here.

Needs approval from an approver in each of these files:

• debian/deepin/OWNERS

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[zccrs]

/+1

[deepin-bot]

TAG Bot

New tag: 0.4.3
DISTRIBUTION: unstable
Suggest: synchronizing this PR through rebase #12

[deepin-ci-robot]

deepin pr auto review

代码审查意见：

1. XML文档结构：

   • 在<request name="start">中新增的<arg name="buffer" type="object" interface="wl_buffer" allow-null="true" summary="buffer to receive frame data, null for export dmabuf"/>，确保wl_buffer接口在文档中已定义，并且allow-null="true"是正确的使用场景。

2. 事件描述：

   • 在<event name="frame">和<event name="dmabuf_frame">中，描述信息已经更新，确保这些描述准确反映了事件的功能和用途。

3. 事件名称：

   • 新增了<event name="dmabuf_object">，需要确认这个事件是否确实需要，以及它是否与现有的<event name="object">有区别。

4. 事件顺序：

   • 在<event name="dmabuf_frame">的描述中提到，这个事件总是直接在<event name="frame">之后发出，需要确认这一顺序是否在实现中得到了保证。

5. 枚举类型：

   • 在<event name="source_failed">中，枚举类型从source_failure更改为treeland_capture_context_v1.source_failure，需要确保新的枚举类型在文档中已定义，并且与旧类型兼容。

6. 请求描述：

   • 在<request name="capture">和<request name="create_session">中，描述信息已经更新，确保这些描述准确反映了请求的功能和用途。

7. 安全性：

   • 在<request name="capture">的描述中提到，调用捕获意味着源被客户端确认且不会改变，这可能会导致安全问题。需要确保这一行为在实现中得到了适当的保护。

8. 文档一致性：

   • 整个文档的描述信息应该保持一致，确保每个事件、请求和枚举类型都有清晰的定义和用途。

9. 性能考虑：

   • 新增的事件和请求可能会影响性能，需要评估这些更改对现有系统的影响，并确保没有引入不必要的性能开销。

10. 错误处理：

    • 在<event name="source_failed">的描述中，提到了selector_busy和user_cancel两种失败原因，需要确保客户端能够正确处理这些错误，并给出适当的反馈。

总体来说，这些更改提高了文档的清晰度和准确性，但需要确保实现中能够正确处理这些新的功能和事件。

[deepin-bot]

TAG Bot

New tag: 0.4.4
DISTRIBUTION: unstable
Suggest: synchronizing this PR through rebase #15