from hmdriver import HMDriver
hdriver = HMDriver("127.0.0.1:5555")
# 启动app
hdriver.start_app(bundle, ability)

# 停止app
hdriver.stop_app(bundle)

# 获取屏幕尺寸：
hdriver.get_screen_size()
w, h = size_dict["width"], size_dict["height"]

# 滑动：
hdriver.swipe(w/2, h*0.8, w/2, h*0.2, 1)
hdriver.fling_up()      # 快速上滑
hdriver.fling_down()    # 快速下滑
hdriver.fling_left()    # 快速左滑
hdriver.fling_right()   # 快速右滑

# 按钮事件
# [键值码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V2/js-apis-keycode-0000001544703985-V2)
hdriver.press_key(1) # 1 是home键的键值

# 根据坐标点击：
hdriver.click(w/2, h/2)
# 双击
hdriver.double_click(w/2, h/2)
# 长按
hdriver.long_click(w/2, h/2)

# 点亮屏幕
hdriver.wake_up()

# 回退：
hdriver.back()

# 返回桌面：
hdriver.home()

# 截图
# local_path参数不为空，则返回截图文件路径
# local_path参数为空，则返回截图的二进制数据
hdriver.get_screenshot_png(local_path=None)

# 元素查找：
ele = hdriver.find_element("text", "设置", timeout_s=15) # 通过文本查找
ele = hdriver.find_element_by_text("设置", timeout_s=15) # 通过文本查找
ele = hdriver.find_element_by_id("btn_setting", timeout_s=15) # 通过id查找
ele = hdriver.find_element_by_type("Button", timeout_s=15) # 通过控件类型查找
ele = hdriver.find_element_by_desc("设置", timeout_s=15) # 通过控件描述查找

# 复合条件查找，复合条件可通过params参数传递，params为字典，可添加多个
ele = hdriver.find_element_by_text("设置", params={"type": "Button"}, timeout_s=15) # 通过文本和控件类型查找

# 获取控件属性
info = ele.properties
text = ele.text
bounds = ele.bounds
# 控件操作
ele.click()
ele.double_click()
ele.long_click()
# 输入文本
ele.clear()
ele.input("test123")
# 滚动查找
ele2 = ele.scrollSearch("text", "设置")